Overview
What is MCP HTTP Wrapper?
MCP HTTP Wrapper is an AWS Lambda HTTP wrapper for Model Context Protocol (MCP) servers. It allows MCP servers to be deployed as serverless HTTP endpoints on AWS, making them accessible via standard RESTful API calls.
How to use MCP HTTP Wrapper?
Install dependencies with npm install, then set up each MCP server under mcp_servers/ by running npm install and npm run build in its directory. For local development, use npm run dev (Serverless Offline) or npm run dev:express (Express). Deploy to AWS with npm run deploy (development) or npm run deploy:prod (production). API endpoints: GET /{serverName} lists available tools; POST /{serverName}/{toolName} calls a tool with a JSON body.
Key features of MCP HTTP Wrapper
- AWS Lambda deployment for serverless MCP servers
- HTTP API to list and call MCP tools
- Local development with Serverless Offline or Express
- Configurable MCP server definitions in
mcp-server-config.ts - TypeScript source code with build and watch scripts
Use cases of MCP HTTP Wrapper
—
FAQ from MCP HTTP Wrapper
What are the prerequisites for using MCP HTTP Wrapper?
Node.js v18 or later, AWS CLI configured with appropriate credentials, and the Serverless Framework are required.
How do I set up MCP servers before deployment?
Navigate to each server directory under mcp_servers/, run npm install to install dependencies, then npm run build to compile the server.
How can I run the service locally?
Use npm run dev to run with Serverless Offline, or npm run dev:express to run with Express for easier debugging.
What API endpoints does MCP HTTP Wrapper expose?
GET /{serverName} returns a list of available tools for that server. POST /{serverName}/{toolName} calls a specific tool with parameters provided in the request body.
