MCP Lambda Server

一个为 AWS Lambda 函数提供带有 SSE 支持的 MCP（Model Context Protocol）服务器基础设施的 Node.js 包。

功能

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

重要说明

• Lambda 响应流仅适用于 Function URLs。它不支持 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';

// Create MCP handler factory with your configuration
const factory = new MCPHandlerFactory({
  tools: {
    summarize: {
      params: {
        text: z.string(),
      },
      handler: async ({ text }) => {
        // Your implementation here - could be any service/model/API
        const summary = await yourSummarizeImplementation(text);
        return {
          content: [{ type: 'text', text: summary }],
        };
      },
    },
  },
  prompts: {
    generate: {
      description: 'Generate content based on a prompt',
      handler: async extra => {
        // Your implementation here - could be any service/model/API
        const result = await yourGenerateImplementation(extra.prompt);
        return {
          content: [{ type: 'text', text: result }],
        };
      },
    },
  },
});

// Export the handler directly
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