MCP Lambda 服务器

一个 Node.js 包，为具有 SSE 支持的 AWS Lambda 函数提供 MCP (模型上下文协议) 服务器基础设施。

特性

• 使 MCP TypeScript SDK 能够与 AWS Lambda 一起工作
• 通过 Lambda 响应流支持服务器发送事件 (SSE)
• 处理 CORS 和 HTTP 方法验证
• TypeScript 支持

重要提示

• Lambda 响应流仅适用于函数 URL。它不适用于 API Gateway 或 Application Load Balancer。
• 响应流仅正式支持 Node.js 运行时。

安装

npm install @markvp/mcp-lambda-layer

用法

创建您的 Lambda 函数并导入该包：

import { MCPHandlerFactory } from '@markvp/mcp-lambda-layer';
import { z } from 'zod';

// 使用您的配置创建 MCP 处理程序工厂
const factory = new MCPHandlerFactory({
  tools: {
    summarize: {
      params: {
        text: z.string(),
      },
      handler: async ({ text }) => {
        // 您的实现 - 可以是任何服务/模型/API
        const summary = await yourSummarizeImplementation(text);
        return {
          content: [{ type: 'text', text: summary }],
        };
      },
    },
  },
  prompts: {
    generate: {
      description: '根据提示生成内容',
      handler: async extra => {
        // 您的实现 - 可以是任何服务/模型/API
        const result = await yourGenerateImplementation(extra.prompt);
        return {
          content: [{ type: 'text', text: result }],
        };
      },
    },
  },
});

// 直接导出处理程序
export const handler = factory.getHandler();

必需的 Lambda 配置

• 运行时：Node.js 18.x 或更高版本
• 处理程序：index.handler
• 内存：最低 128 MB（根据您的需要调整）
• 超时：建议 120 秒
• 函数 URL：必需，并且必须启用响应流
• API Gateway/ALB：不支持流式传输

包内容

此包提供：

• 具有 SSE 传输的 MCP 服务器实现
• 协议处理 (JSON-RPC)
• 流式响应支持
• 类型定义和接口

您的 Lambda 函数提供：

• 工具和提示实现
• 业务逻辑
• 任何必要的 API 客户端或服务
• 配置

许可证

MIT