🧠 serverless-mcp-server

一个超简单的模型上下文协议 (MCP) 服务器，部署在 AWS Lambda 上，并通过 Amazon API Gateway 公开，使用 Serverless Framework 部署。 这个骨架基于 Frédéric Barthelet 的出色工作：他开发了一个 middy 中间件，用于将模型上下文协议 (MCP) 服务器与 AWS Lambda 函数集成，位于 这个仓库 中。

🛠 功能

• 🪄 使用 @modelcontextprotocol/sdk 的最小 MCP 服务器设置
• 🚀 部署为单个 AWS Lambda 函数
• 🌐 通过 API Gateway 在 /mcp 公开的 HTTP POST 端点
• 🔄 支持通过 serverless-offline 进行本地开发
• 🧪 包含一个简单的示例工具 (add)，带有 JSON-RPC 交互

📦 项目结构

serverless-mcp-server/
├── src/                    # 源代码
│   └── index.js                # MCP 服务器处理程序
├── .gitignore              # Git 忽略文件
├── package.json            # 项目依赖
├── package-lock.json       # 项目锁定文件
├── README.md               # 此文档文件
└── serverless.yml          # Serverless Framework 配置

🛠 前提条件

• Node.js v22+
• Open Source Serverless 或 Serverless Framework v3+
• Serverless Offline

🚀 快速开始

1. 安装依赖:

npm install

2. 全局安装 open source severless (如果尚未安装):

npm install -g osls

3. 使用 serverless-offline 在本地运行

npm sls offline

本地端点将在以下位置可用： POST http://localhost:3000/dev/mcp

请注意，使用 serverless-offline 时，默认情况下会添加 /dev/ 阶段，反映 Api Gateway V1 (REST API) 的行为。

切换到 Api Gateway V2 (HTTP API)

如果要使用 API Gateway V2，可以更改 serverless.yml 文件，在 events 部分使用 httpApi 而不是 http。 这将允许您使用 HTTP API 而不是 REST API。

functions:
  mcpServer:
    handler: src/index.handler
    events:
      - httpApi:
          path: mcp
          method: post

本地端点将在以下位置可用： POST http://localhost:3000/mcp

请注意，使用 API Gateway V2 时，不需要 /dev/ 阶段。 请注意，您应该相应地更改测试 curl 和 postman 请求。

🧪 使用 curl 请求进行测试

列出工具

curl --location 'http://localhost:3000/dev/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/dev/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
    }
  }
}'

🧬 代码分解

此代码基于 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

只需运行：

sls deploy

部署后，MCP 服务器将在命令输出的 URL 上生效。

📘 许可证

MIT — 随意 fork、调整和部署您自己的版本！