Simple Mcp Server On Lambda
What is Simple Mcp Server On Lambda
simple-mcp-server-on-lambda is a prototype of a simple MCP Server that operates natively on AWS Lambda and Amazon API Gateway, utilizing the Streamable HTTP transport introduced in version 2025-03-26.
Use cases
Use cases include developing serverless applications, testing MCP protocols, and creating tools that require quick and efficient server responses.
How to use
To use simple-mcp-server-on-lambda, install the necessary dependencies using npm, bootstrap the server with Terraform, and set the environment variable for the MCP Server endpoint. Finally, run the client to observe responses from the server.
Key features
Key features include native operation on AWS Lambda, no need for additional bridging components, and the use of Streamable HTTP transport for efficient communication.
Where to use
simple-mcp-server-on-lambda can be used in cloud-based applications, serverless architectures, and any environment where lightweight, scalable server solutions are required.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Simple Mcp Server On Lambda
simple-mcp-server-on-lambda is a prototype of a simple MCP Server that operates natively on AWS Lambda and Amazon API Gateway, utilizing the Streamable HTTP transport introduced in version 2025-03-26.
Use cases
Use cases include developing serverless applications, testing MCP protocols, and creating tools that require quick and efficient server responses.
How to use
To use simple-mcp-server-on-lambda, install the necessary dependencies using npm, bootstrap the server with Terraform, and set the environment variable for the MCP Server endpoint. Finally, run the client to observe responses from the server.
Key features
Key features include native operation on AWS Lambda, no need for additional bridging components, and the use of Streamable HTTP transport for efficient communication.
Where to use
simple-mcp-server-on-lambda can be used in cloud-based applications, serverless architectures, and any environment where lightweight, scalable server solutions are required.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
DEPRECATED
Use this repo instead - https://github.com/aws-samples/sample-serverless-mcp-servers
DEPRECATED
A simple MCP Server running natively on AWS Lambda and Amazon API Gateway without any extra bridging components or custom transports. This is now possible thanks to the Streamable HTTP transport introduced in v2025-03-26. This is merely a prototype.
Architecture is as simple as it gets:
Prereqs
- AWS CLI
- Terraform
Instructions
Install dependencies:
cd src
npm install
cd ..
Bootstrap server and set env var with MCP Server endpoint:
cd terraform
terraform init
terraform plan
terraform apply
export SIMPLE_MCP_SERVER_ENDPOINT=$(terraform output --raw endpoint_url)
cd ..
Note: It might take a few seconds for API Gateway endpoint to become operational.
Run client:
node src/client.js
Observe the response:
> node client.js
> listTools response: { tools: [ { name: 'ping', inputSchema: [Object] } ] }
> callTool:ping response: { content: [ { type: 'text', text: 'pong' } ] }
Learn about mcp
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
