Sample Serverless MCP Server

このプロジェクトは、公式のTypeScript MCPサーバーをストリーミングHTTPプロトコルをサポートするように改造し、Amazon Lambdaを通じてデプロイする実装方法を示しています。核心機能には、ストリーミング転送プロトコルのサポート、Lambdaベースの弾性デプロイ、コスト最適化が含まれ、既存のHTTPインフラストラクチャとシームレスに統合する必要があるシナリオに適しています。

開発者ツールクラウドプラットフォーム #ストリーミング転送 #Lambdaデプロイ #HTTPプロトコル #コスト最適化 .TypeScript

スコア : 2ポイント

ダウンロード数 : 5.6K

更新時間 : 2025-04-28

サイトを開く

GitHub MCPサーバーとは？

GitHub MCPサーバーは、Streamable HTTPプロトコルをサポートするMCPサーバーの実装で、Amazon Lambdaの弾性拡張機能を利用して、コストとパフォーマンスのバランスを最適化します。動的なコンテキスト優先度制御をサポートし、既存のHTTPインフラストラクチャにシームレスに統合できます。

GitHub MCPサーバーの使い方は？

AWS環境変数を設定し、依存関係をインストールしてLambdaにデプロイすることで、すぐにストリーミングHTTP MCPサーバーを起動できます。

適用シナリオ

効率的なストリーミング転送、動的なコンテキスト管理、低コストの拡張が必要なアプリケーションシナリオ、例えばリアルタイムデータ処理や大きなファイルの転送に適しています。

主要機能

ストリーミングHTTPプロトコルのサポート

HTTP Chunked Transfer Encodingを通じてデータストリームの転送を実現します。

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

必要に応じてコンテキストの優先度を動的に調整し、システムの応答効率を向上させます。

Amazon Lambdaの弾性デプロイ

クラウド関数ベースの弾性アーキテクチャで、必要に応じてリソースを拡張します。

DynamoDBとS3へのログ保存

リクエストログは自動的にDynamoDBとS3に保存され、後の分析に便利です。

利点

従来のサーバーを維持する必要がなく、運用の複雑さを軽減します。

大規模な同時リクエストをサポートし、システムのスループットを向上させます。

柔軟なコストモデルで、実際の使用量に応じて支払います。

既存のHTTPインフラストラクチャにシームレスに統合できます。

制限

初回のデプロイにはAWS環境変数の設定が必要です。

ネットワーク遅延に敏感で、超低遅延のシナリオには適していません。

GitHub APIの権限管理に依存しています。

使い方

プロジェクトリポジトリをクローンする

GitHubからプロジェクトコードをローカル環境にクローンします。

依存関係をインストールする

Node.jsの依存関係をインストールし、開発ツールを初期化します。

GitHubトークンを設定する

serverless.ymlに個人用アクセストークンを設定します。

ローカルでテストする

ローカルサーバーを起動してテストします。

AWS Lambdaにデプロイする

デプロイを完了し、ストリーミングHTTP MCPサーバーを実行します。

使用例

例1：ローカルでのテスト

ローカル環境でGitHub MCPサーバーの機能を検証します。

例2：本番環境へのデプロイ

MCPサーバーをAWS Lambdaにデプロイし、ストリーミングHTTPプロトコルを有効にします。

よくある質問

GitHub個人用アクセストークンを生成する方法は？

デプロイ中に権限エラーが発生した場合はどうすればいいですか？

MCPサーバーのパフォーマンスを監視する方法は？

HTTPSをサポートしていますか？

🚀 サーバーレスストリーミングHTTP MCPサーバーのサンプル

このプロジェクトは、Amazon LambdaとStreamable HTTPプロトコルをベースにしたGitHub MCP Serverの実装例です。この実装により、Streamable HTTPプロトコルをサポートし、Amazon Lambda上でのデプロイが可能になります。

🚀 クイックスタート

前提条件

Node.js 20以上のバージョン
設定済みのAWS CLI
OSS-Serverless CLIツール

GitHub MCP ServerをAmazon Lambdaにデプロイする

このプロジェクトでは、GITHUB_PERSONAL_ACCESS_TOKENの設定が必要です。このトークンはAmazon 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

# Amazon Lambdaにデプロイする
npm sls deploy

✨ 主な機能

Streamable HTTP MCPプロトコルをサポート
Amazon Lambdaによる弾力的なデプロイ
コストとパフォーマンスの最適化

📦 インストール

前提条件

Node.js 20以上のバージョン
設定済みのAWS CLI
OSS-Serverless CLIツール

手順

# リポジトリをクローンする
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

# Amazon Lambdaにデプロイする
npm sls deploy