Cdk Serverless MCP Server

🚀 🧠 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、調整並部署您自己的版本！