🚀 🧠 cdk-serverless-mcp-server

这是一个极为简单的模型上下文协议（MCP）服务器，它部署在AWS Lambda上，并通过Amazon API Gateway对外暴露，使用AWS CDK完成部署。此项目骨架源于Frédéric Barthelet的出色工作，他在这个仓库中开发了一个用于将MCP服务器集成到AWS Lambda函数的middy中间件。

🚀 快速开始

安装依赖

npm install

全局安装AWS CDK（若未安装）

npm install -g aws-cdk

本地测试

使用Jest进行本地开发测试：

npm run test

✨ 主要特性

• 🪄 使用@modelcontextprotocol/sdk的最小MCP服务器设置
• 🚀 作为单个AWS Lambda函数部署
• 🌐 通过API Gateway在/mcp路径下暴露HTTP POST端点
• 🔄 支持本地开发测试使用Jest
• 🧪 包含一个简单的示例工具（加法）与JSON - RPC交互

📦 安装指南

部署到AWS

安装层依赖项

npm run layer-dependencies-install

部署堆栈

cdk bootstrap
cdk deploy

部署完成后，MCP服务器将在控制台输出的URL上可用。

💻 使用示例

基础用法

列出工具

curl --location 'http://your_api Gateway_URL/mcp' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": 1,
    "method": "list_tools"
}'

调用加法工具

curl --location 'http://your_api Gateway_URL/mcp' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": 2,
    "method": "tools_call",
    "params": {
        "name": "add",
        "arguments": {
            "a": 5,
            "b": 3
        }
    }
}'

代码分解示例

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托管的MCP服务器",
  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());

📚 详细文档

长故事

• 📖 在dev.to上阅读完整的文章
• 📖 在dev.to上阅读该系列的第一篇文章

项目结构

cdk-serverless-mcp-server/
├── __tests__/                              # Jest测试文件夹
├── bin/                                    # CDK入口点
├── cdk-serverless-mcp-server.ts                # CDK应用程序
├── lib/                                    # CDK堆栈
│   └── cdk-serverless-mcp-server-stack.ts      # CDK堆栈
├── src/                                    # 源代码
│   └── index.mjs                               # MCP服务器处理程序
├── .gitignore                              # Git忽略文件
├── cdk.json                                # CDK项目配置
├── package.json                            # 项目依赖
├── package-lock.json                       # 项目锁定文件
├── README.md                               # 此文档文件

先决条件

• Node.js v22+版本
• AWS CDK v2+

📄 许可证

MIT — 欢迎 fork、调整并部署您自己的版本！