Middy MCP

用于AWS Lambda函数与Model Context Protocol (MCP)服务器集成的Middy中间件。

描述

Middy MCP是一个中间件，它使AWS Lambda函数与Model Context Protocol服务器之间的无缝集成成为可能。它提供了一种方便的方式来处理Lambda函数中的MCP请求和响应，使用Middy中间件框架。它支持通过API Gateway（包括REST API / v1和HTTP API / v2）以及ALB发送到AWS Lambda的请求，使用代理集成。

免责声明：以这种方式托管您的MCP服务器仅与使用至少2025-03-26协议版本的MCP客户端兼容。

安装

pnpm install middy-mcp

要求

• Node.js >= 18.0.0
• Middy >= 6.0.0

使用

此中间件可以抛出HTTP异常，因此与@middy/http-error-handler结合使用可能会很方便。

以下是一个最小Lambda函数处理器文件的示例。将此lambda部署为API Gateway上POST路由的代理集成，即可开始使用。

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";

// 创建一个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());

许可证

本项目根据MIT许可证发布 - 详情请参阅LICENSE文件。

贡献

欢迎贡献！请随意打开问题或提交拉取请求 🚀！