🧠 cdk-serverless-mcp-server

What is cdk-serverless-mcp-server?

cdk-serverless-mcp-server is a minimal Model Context Protocol (MCP) server deployed as an AWS Lambda function and exposed via Amazon API Gateway, using the AWS CDK for infrastructure as code. It is designed for developers who want a quick, serverless MCP endpoint on AWS.

How to use cdk-serverless-mcp-server?

Install dependencies with npm install, optionally install AWS CDK globally, then run npm run layer-dependencies-install and deploy with cdk bootstrap and cdk deploy. The server is accessible at the output URL at the /mcp path. Local testing is supported via Jest (npm run test).

Key features of cdk-serverless-mcp-server

• Minimal MCP server setup using @modelcontextprotocol/sdk
• Single AWS Lambda function deployment
• HTTP POST endpoint at /mcp via API Gateway
• Local development testing with Jest
• Includes an example add tool using JSON-RPC

Use cases of cdk-serverless-mcp-server

• Deploy a lightweight MCP server without managing EC2 or containers
• Integrate MCP tools with other AWS serverless services
• Prototype and test MCP capabilities in a serverless environment
• Provide a scalable, pay-per-use MCP endpoint for LLM integration

FAQ from cdk-serverless-mcp-server

What are the prerequisites for deploying cdk-serverless-mcp-server?

Node.js v22 or later and AWS CDK v2 or later are required.

How is the MCP server exposed?

It is exposed as a single HTTP POST endpoint at /mcp via Amazon API Gateway.

Can I test the server locally?

Yes, run npm run test to run Jest tests that simulate MCP interactions locally.

Does cdk-serverless-mcp-server include authentication?

The README does not mention any authentication or authorization mechanisms; the endpoint is publicly accessible via the API Gateway URL.

Where does my data/state live?

The server is stateless; tool arguments and responses are handled in-memory per invocation. No persistent storage is described.