Cdk Serverless MCP Server

一個基於AWS Lambda和API Gateway的簡單MCP服務器，使用AWS CDK部署，支持本地測試和遠程調用。

開發者工具人工智能聊天機器人 #MCP服務 #無服務器 #AWS CDK #Lambda .TypeScript

評分 : 2分

下載量 : 7

更新時間 : 2025-04-28

什麼是CDK Serverless MCP Server?

這是一個部署在AWS雲上的輕量級MCP服務器，允許開發者通過簡單的HTTP接口與AI模型交互。它使用無服務器架構，無需管理基礎設施。

如何使用MCP服務器?

通過發送JSON-RPC格式的HTTP請求到提供的API端點，您可以列出可用工具或調用特定工具功能。

適用場景

適用於需要快速集成AI功能的應用程序，特別是當您希望避免管理服務器基礎設施時。

主要功能

MCP協議支持完全兼容Model Context Protocol標準，提供規範的AI工具調用接口

無服務器架構基於AWS Lambda實現，自動擴展，按使用付費

一鍵部署使用AWS CDK工具鏈，幾分鐘內即可完成部署

自定義工具支持添加您自己的AI工具和功能

優勢與侷限性

優勢

低成本：只在被調用時產生費用

高可用性：基於AWS全球基礎設施

易擴展：自動處理流量變化

開發友好：包含本地測試工具

侷限性

冷啟動延遲：首次調用可能有延遲

執行時間限制：單次調用最長15分鐘

功能有限：當前僅提供基礎MCP功能

如何使用

安裝依賴

確保系統已安裝Node.js和AWS CDK

本地測試

運行測試確保一切正常

部署到AWS

使用CDK部署到您的AWS賬戶

調用API

使用curl或任何HTTP客戶端調用部署的API

使用案例

列出可用工具獲取服務器支持的所有工具列表

使用加法工具調用內置的加法工具計算兩個數的和

常見問題

什麼是MCP協議?

部署需要多少費用?

如何添加自定義工具?

支持哪些編程語言調用?

🚀 🧠 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());

📚 詳細文檔

長故事

項目結構

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                               # 此文檔文件