Serverless MCP Server

🧠 无服务器mcp服务器

一个超级简单的模型上下文协议（MCP）服务器，部署在AWS Lambda上，通过Amazon API网关公开，使用无服务器框架部署。

长话短说

📖在dev.to上阅读完整文章

🛠 特性

• 🪄 使用@modelcontextprotocol/sdk进行最低限度的MCP服务器设置
• 🚀 作为单个AWS Lambda函数部署
• 🌐 通过位于/mcp的API网关公开的HTTP POST端点
• 🔄 通过无服务器离线支持本地开发
• 🧪 包括一个具有JSON-RPC交互的简单示例工具（add）

📦 项目结构

serverless-mcp-server/
├── src/                    # Source code
│   └── index.js                # MCP server handler
├── .gitignore              # Git ignore file
├── package.json            # Project dependencies
├── package-lock.json       # Project lock file
├── README.md               # This documentation file
└── serverless.yml          # Serverless Framework config

🛠 先决条件

• Node.js v22+
• 开源无服务器 或无服务器框架v3+
• 无服务器离线

🚀 入门指南

1. 安装依赖项：

npm install

1. 全局安装开源无服务器（如果尚未安装）：

npm install -g osls

1. 使用无服务器脱机在本地运行

npm sls offline

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

请注意 /dev/ stage在使用serverless-offline时默认添加，反映Api网关V1（REST Api）行为。

切换到Api网关V2（HTTP Api）

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

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

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

请注意 /dev/ 在使用API网关V2时不需要阶段。 请注意，您应该相应地更改测试curl和邮递员请求。

🧪 使用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
}'

➕ 使用添加工具

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
    }
  }
}'

🧪 Test with 是

其中包括一些基本测试 __tests__ 文件夹。您可以使用以下方式运行它们：

npm run test

🧬 代码分解

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上运行。

🔖 语录

以下通讯中引用了该存储库：

• 无服务器倡导者通讯#33 靠近 李·吉尔摩 （AWS英雄）

📘 许可证

麻省理工学院——请随意分叉、调整和部署您自己的版本！