Lambda MCP Server

🚀 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 安全最佳實踐。