Sample Serverless MCP Server

🚀 無服務器流式HTTP MCP服務器示例

本項目基於亞馬遜Lambda和Streamable HTTP協議，實現了一個Github MCP Server。它展示瞭如何將官方TypeScript MCP Server轉換為支持Streamable HTTP協議，並通過亞馬遜Lambda進行部署，為相關開發提供了實用的參考。

🚀 快速開始

先決條件

• Node.js 20+版本
• 配置好的AWS CLI
• OSS - Serverless CLI工具

部署Github MCP Server到亞馬遜Lambda

此項目需要設置GITHUB_PERSONAL_ACCESS_TOKEN，該令牌已存儲在亞馬遜Lambda環境變量中。⚠️ 請勿將serverless.yml文件提交到公開的GitHub倉庫。

# 克隆倉庫
git clone https://gitlab.aws.dev/wsuam/sample-serverless-mcp-server.git
cd sample-serverless-mcp-server/src/github/

# 安裝依賴項
npm install
npm install -g osls

# 將示例配置文件複製並重命名
cp serverless.example.yml serverless.yml
# 編輯serverless.yml文件，設置GITHUB_PERSONAL_ACCESS_TOKEN為<您的GitHub個人訪問令牌>

# 測試本地運行
npm sls offline

# 部署到亞馬遜Lambda
npm sls deploy

✨ 主要特性

• 支持Streamable HTTP MCP協議，利用MCP v2025.03.26引入的新功能，如基於HTTP分塊傳輸編碼的流傳輸、動態上下文優先級控制，以及與現有HTTP基礎設施的無縫集成。
• 基於亞馬遜Lambda的彈性部署，可根據實際需求靈活調整資源。
• 實現了成本性能的優化平衡。

📦 安裝指南

環境準備

確保滿足以下先決條件：

• Node.js 20+版本
• 配置好的AWS CLI
• OSS - Serverless CLI工具

部署步驟

按照“快速開始”部分的部署步驟操作，即可將Github MCP Server部署到亞馬遜Lambda。

💻 使用示例

基礎用法

在本地測試運行：

npm sls offline

高級用法

將項目部署到亞馬遜Lambda：

npm sls deploy

📚 詳細文檔

Github MCP Server在亞馬遜Lambda上的架構

架構概述

該項目採用以下架構：

• API Gateway：負責處理HTTP請求。
• Lambda函數：執行MCP Server邏輯。
• Streamable HTTP：實現流式響應。
• DynamoDB和S3存儲請求日誌（此功能尚未完成）。

開發指南

1. 配置AWS憑證。
2. 運行npm sls offline。
3. 按照提示完成部署配置。

貢獻說明

歡迎提交拉取請求。在提交之前，請確保：

• 代碼遵循項目規範。
• 所有測試通過。
• 文檔已更新。

🔧 技術細節

該實現利用了MCP v2025.03.26引入的新功能，包括基於HTTP分塊傳輸編碼的流傳輸、動態上下文優先級控制，以及與現有HTTP基礎設施的無縫集成。通過這些功能，項目實現了對Streamable HTTP MCP協議的支持，同時基於亞馬遜Lambda實現了彈性部署和成本性能的優化平衡。

📄 許可證

此庫採用MIT - 0許可證，詳見LICENSE文件。

項目狀態

該項目正在積極開發中。歡迎提出問題和建議！