🧠 sam-serverless-mcp-server

🧠 sam-serverless-mcp-server

一个极简的模型上下文协议（MCP）服务，部署在 AWS Lambda 上，并通过 Amazon API Gateway 对外提供服务，使用 Serverless Application Model（SAM）进行部署。 此模板基于 Frédéric Barthelet 的出色成果：他开发了一个 middy 中间件，用于将模型上下文协议（MCP）服务集成到 AWS Lambda 函数中，详见此仓库

长话短说

📖 在 dev.to 阅读本系列文章

🛠 功能

• 🪄 使用 @modelcontextprotocol/sdk 搭建极简 MCP 服务
• 🚀 部署为单个 AWS Lambda 函数
• 🌐 通过 API Gateway 在 /mcp 暴露 HTTP POST 端点
• 🔄 支持通过 SAM 进行本地开发
• 🧪 包含一个简单的示例工具（add），并支持 JSON-RPC 交互

📦 项目结构

sam-serverless-mcp-server/
├── __tests__/              # Jest tests
├── src/                    # Source code
│   └── index.js                # MCP server handler
├── .gitignore              # Git ignore file
├── buildspec.yml           # Buildspec file for AWS CodeBuild and CodePipeline (CI/CD)
├── jest.config.mjs         # Jest config file
├── package.json            # Project dependencies
├── package-lock.json       # Project lock file
├── README.md               # This documentation file
├── samconfig.toml          # Serverless Application Model config
└── template.yml            # Serverless Application Model template

🛠 前置条件

• Node.js v22+
• Docker
• AWS CLI
• SAM CLI

🚀 开始使用

1. 安装依赖：

npm install

2. 使用 SAM 在本地运行

sam local start-api

本地端点地址： POST http://localhost:3000/mcp

切换到 Api Gateway V2（HTTP API）

如果要使用 API Gateway V2，可以修改 template.yml 文件，在 Events 部分使用 HttpApi 代替 Api。这样就能使用 HTTP API，而不是 REST API。 这样就能使用 HTTP API，而不是 REST API。

Events:
  McpHttpApi:
    Type: HttpApi  # 👈 This switches to HTTP API (v2)
    Properties:
      Path: /mcp
      Method: POST

🧪 使用 curl 请求进行测试

列出工具

curl --location 'http://localhost:3000/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json' \
--header 'jsonrpc: 2.0' \
--data '{
  "jsonrpc": "2.0",
  "method": "tools/list",
  "id": 1
}'

➕ 使用 add 工具

curl --location 'http://localhost:3000/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json' \
--header 'jsonrpc: 2.0' \
--data '{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "add",
    "arguments": {
      "a": 5,
      "b": 3
    }
  }
}'

🧪 使用 jest 测试

__tests__ 文件夹中包含一些基础测试。你可以运行以下命令：

npm run test

🧬 代码解析

此代码基于 Frédéric Barthelet 的出色成果：他开发了一个 middy 中间件，用于将模型上下文协议（MCP）服务集成到 AWS Lambda 函数中，详见此仓库

src/index.js

import middy from "@middy/core";
import httpErrorHandler from "@middy/http-error-handler";
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { z } from "zod";
import mcpMiddleware from "middy-mcp";

const server = new McpServer({
  name: "Lambda hosted MCP Server",
  version: "1.0.0",
});

server.tool("add", { a: z.number(), b: z.number() }, async ({ a, b }) => ({
  content: [{ type: "text", text: String(a + b) }],
}));

export const handler = middy()
  .use(mcpMiddleware({ server }))
  .use(httpErrorHandler());

📡 部署到 AWS

只需运行：

sam build
sam deploy --guided

部署完成后，MCP 服务将在命令输出的 URL 上运行。

📘 许可证

MIT — 欢迎 fork、修改并部署你自己的版本！