🧠 sam-serverless-mcp-server

What is 🧠 sam-serverless-mcp-server?

A minimal Model Context Protocol (MCP) server deployed on AWS Lambda and exposed via Amazon API Gateway, using the Serverless Application Model (SAM). It is intended for developers who want to host an MCP server on AWS serverless infrastructure.

How to use 🧠 sam-serverless-mcp-server?

Install dependencies with npm install, run locally with sam local start-api (endpoint at POST http://localhost:3000/mcp), or deploy to AWS with sam build && sam deploy --guided. Test the included add tool using curl or the Jest test suite.

Key features of 🧠 sam-serverless-mcp-server

• Minimal MCP server setup using @modelcontextprotocol/sdk
• Deployed as a single AWS Lambda function
• HTTP POST endpoint exposed via API Gateway at /mcp
• Supports local development via SAM
• Includes a simple example tool (add) with JSON-RPC interaction

Use cases of 🧠 sam-serverless-mcp-server

• Deploy an MCP server entirely on AWS serverless with minimal configuration
• Quickly prototype and test MCP tool interactions through a public API endpoint
• Integrate MCP capabilities into existing AWS serverless workflows
• Use as a starter template for building custom MCP tools on Lambda

FAQ from 🧠 sam-serverless-mcp-server

What are the prerequisites for running this server?

Node.js v22+, Docker, AWS CLI, and SAM CLI are required.

How do I run the server locally?

Run sam local start-api and then send POST requests to http://localhost:3000/mcp.

How do I deploy to AWS?

Run sam build followed by sam deploy --guided. The deployment output will provide the live URL.

Can I use API Gateway V2 (HTTP API)?

Yes, change the event type from Api to HttpApi in the template.yml file under the Events section.

What transport protocol does the server use?

It uses HTTP POST with JSON-RPC 2.0 payloads, exposed through Amazon API Gateway.