sample-serverless-mcp-server

sample-serverless-mcp-server

Amazon Lambda と Streamable HTTP プロトコルに基づく Github MCP サーバーの実装です。

プロジェクトの説明

このプロジェクトでは、公式の TypeScript MCP サーバーを Streamable HTTP プロトコルに対応させ、Amazon Lambda 経由でデプロイする方法を紹介します。この実装では、MCP v2025.03.26 で導入された次の新機能を活用しています。

• HTTP Chunked Transfer Encoding に基づくストリーム転送

• 動的なコンテキストの優先度制御

• 既存の HTTP インフラストラクチャとのシームレスな統合

主な機能

• Streamable HTTP MCP プロトコルのサポート

• Amazon Lambda に基づく柔軟なデプロイ

• コストとパフォーマンスの最適なバランス

Amazon Lambda 上の MCP サーバーアーキテクチャ

クイックスタート

前提条件

• Node.js 20+
• AWS CLI configured
• OSS-Serverless CLI

Serverless Streamable HTTP MCP サーバー

• Github MCP サーバー

Amazon Lambda で Github MCP サーバーをデプロイする方法：

このプロジェクトでは、GITHUB_PERSONAL_ACCESS_TOKEN を設定する必要があります。このトークンは Amazon Lambda の環境変数に保存されています。

serverless.yml を GitHub の公開リポジトリに絶対に登録しないでください。

# Clone repository
git clone https://gitlab.aws.dev/wsuam/sample-serverless-mcp-server.git
cd sample-serverless-mcp-server/src/github/

# Install dependencies
npm install
npm install -g osls

#Set your github personal access token in serverless.yml 
cp serverless.example.yml serverless.yml
#edit serverless.yml , GITHUB_PERSONAL_ACCESS_TOKEN: <Your GitHub Personal Access Token>


# Test local
npm sls offline

# Deploy to AWS Lambda
npm sls deploy

アーキテクチャの概要

このプロジェクトでは、次のアーキテクチャを使用します。

• API Gateway：HTTP リクエストを処理します

• Lambda：MCP サーバーのロジックを実行します

• Streamable HTTP：ストリーミングレスポンスを実装します

• DynamoDB と S3 にリクエストログを保存します（この部分はまだ実装されていません）。

開発ガイド

1. AWS 認証情報を設定します
2. npm sls offline を実行します
3. プロンプトに従ってデプロイ設定を完了します

貢献

プルリクエストを歓迎します。提出する前に、次の点を確認してください。

• コードがプロジェクトの規約に従っていること
• すべてのテストに合格すること
• ドキュメントが更新されていること

ライセンス

このライブラリは MIT-0 ライセンスの下でライセンスされています。LICENSE ファイルを参照してください。

プロジェクトの状況

プロジェクトは現在活発に開発中です。問題や提案を歓迎します。