How aws-samples/sample-serverless-mcp-servers works
Project type and purpose
• This is an open-source collection of sample MCP (Model Context Protocol) Server implementations.
• It demonstrates four “production-style” deployment patterns:
• Stateless on Lambda (Node.js + Terraform)
• Stateless on Lambda (Python + SAM)
• Stateless on ECS (Node.js + Terraform)
• Stateful on ECS (Node.js + Terraform)
• Plus a “lambda-ops-mcp-server” PoC for local MCP server operations.
File structure
• Top-level directories each correspond to one sample deployment.
• Each sample folder has two halves:
a. src/mcpserver (+ optional authorizer) and src/mcpclient
b. IaC/config (Terraform .tf files or SAM template) and build scripts (publish-to-ecr.sh, makefile)
• The lambda-ops-mcp-server folder is a standalone Node.js project with tools/ and utils/ subfolders.
Extract architecture from the README
• Key technologies: AWS Lambda, API Gateway, AWS ECS (Fargate/EC2), ALB, Terraform, AWS SAM, Node.js, Python.