JinDaGe - Lambda-MCP-Server MCP Details

article

README

🚀 Lambda MCP 服务器

Lambda MCP 服务器基于 AWS Lambda 实现，专门用于支持 MCP 协议。本项目提供了完整的技术文档，助您快速上手和部署。

🚀 快速开始

快速部署

克隆仓库

git clone <repository-url>

进入服务器目录

cd server-http-python-lambda

使用 SAM 部署

sam build
sam deploy --guided

⚠️ 重要提示

在部署过程中，系统会提示您输入 McpAuthToken。这是调用端点所需的授权令牌。此实现使用 AWS API Gateway 作者器，并将 McpAuthToken 作为环境变量传递。可以根据需要替换为其他生产实现。

客户端设置

进入客户端目录

cd client-http-typescript-docker

运行辅助脚本

run-client.sh

✨ 主要特性

装饰器模式：在 server/app.py 中添加新工具时，使用装饰器模式，可自动处理类型验证、请求解析、响应格式化、错误处理和 MCP 文档生成。
身份验证升级：版本 1.1.0 将 API Key 验证替换为通过 Authorization 标头传递的 Bearer Token 验证，并添加了 API Gateway 自定义作者器进行令牌验证。
多环境支持：支持 AWS Lambda 环境，使用 DynamoDB 管理会话状态，还提供了带有 Amazon Bedrock 集成的 TypeScript HTTP 客户端。

💻 使用示例

添加新工具

在 server/app.py 中添加新的工具，使用装饰器模式：

@mcp_server.tool()
def my_new_tool(param1: str, param2: int) -> str:
    """您的工具描述。
    
    参数：
        param1：参数 1 的描述
        param2：参数 2 的描述
        
    返回值：
        描述返回值的说明
    """
    # 您的工具实现
    return f"Processed {param1} with value {param2}"

装饰器功能说明

⚠️ 重要提示

装饰器会自动处理以下内容：

类型验证

请求解析

响应格式化

错误处理

MCP 文档生成

🔧 技术细节

在编写时，TypeScript MCP SDK 是少数（如果不是唯一）支持基于 HTTP 的 MCP 通信的实现。
生产环境中，请考虑使用 AWS IAM 最佳实践进行身份验证和授权。

📄 许可证

本库 licensed under MIT-0 License，请参阅 LICENSE 文件。

📚 详细文档

版本更新

版本 1.1.0

将 API Key 验证替换为通过 Authorization 标头传递的 Bearer Token 验证
添加了 API Gateway 自定义作者器进行令牌验证
更新客户端配置以使用 Bearer Tokens
制作符合 MCP 标准的身份验证系统
增加变更日志部分

版本 1.0.0

初始版本发布
基于 AWS Lambda 的基本 MCP 服务器实现
使用 DynamoDB 管理会话状态
示例工具实现
带有 Amazon Bedrock 集成的 TypeScript HTTP 客户端

安全性

有关安全问题的通知，请参阅 CONTRIBUTING。

有关 AWS 和 Amazon Bedrock 的安全性，请参考 AWS 安全文档和 Amazon Bedrock 安全最佳实践。

Lambda-MCP-Server