Serverless MCP Server

🚀 無服務 MCP 服務器

這是一個極為簡單的模型上下文協議 (MCP) 服務器，部署於 AWS Lambda 之上，並通過 Amazon API Gateway 接口對外暴露，藉助 Serverless Framework 完成部署。該框架依託 Frédéric Barthelet 的卓越成果，他開發了一個 middy 中間件，用於將模型上下文協議 (MCP) 服務器與 AWS Lambda 函數集成，具體實現可查看 此倉庫。

🚀 快速開始

此無服務 MCP 服務器的部署和使用較為便捷，以下是詳細步驟。

安裝依賴

npm install

啟動本地服務器

sls local start

啟動後，訪問 http://localhost:3000 即可查看文檔。

部署到 AWS

sls deploy

部署完成後，控制檯會輸出 MCP 服務的 URL。

✨ 主要特性

• 🪄 運用 @modelcontextprotocol/sdk，實現最小化的 MCP 服務器設置。
• 🚀 以單個 AWS Lambda 函數的形式進行部署。
• 🌐 通過 API Gateway 的 HTTP POST 接口，在 /mcp 端點暴露服務。
• 🔄 支持使用 serverless-offline 進行本地開發。
• 🧪 包含一個簡單的示例工具（加法）以及 JSON-RPC 交互。

📦 安裝指南

先決條件

• Node.js v22+
• 開源無服務 或 Serverless Framework v3+
• Serverless Offline

項目結構

serverless-mcp-server/
├── src/                    # 源代碼目錄
│   └── index.js                # MCP 服務器處理程序
├── .gitignore              # Git 忽略文件
├── package.json            # 項目依賴
├── package-lock.json       # 項目鎖定文件
├── README.md               # 此文檔文件
└── serverless.yml          # Serverless Framework 配置

💻 使用示例

基礎用法

在 src/index.js 中定義了一個簡單的“加法”工具：

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

請求示例

{
  "tool": "add",
  "args": {
    "a": 1,
    "b": 2
  }
}

響應示例

{
  "content": [
    { "type": "text", "text": "3" }
  ]
}

📚 詳細文檔

📖在此處閱讀完整的文章

📄 許可證

本項目採用 MIT 許可證，您可以隨意 fork、修改和部署自己的版本！