MCP Server Http Wrapper

🚀 MCP HTTP 包装器

AWS Lambda 上の Model Context Protocol サーバー用の HTTP ラッパーです。このラッパーは、MCP サーバーを AWS Lambda 環境で効率的に動作させるための機能を提供します。

🚀 クイックスタート

この MCP HTTP 包装器を使用するには、まず必要な前提条件を満たし、インストールと設定を行います。その後、ローカルで開発を行い、最後に AWS 環境にデプロイすることができます。

✨ 主な機能

• AWS Lambda 上での MCP サーバーの HTTP ラッピング機能。
• ローカル開発環境での簡単な実行とデバッグ機能。
• 開発環境と本番環境へのデプロイ機能。

📦 インストール

前提条件

• Node.js (v18 以上)
• 適切なクレデンシャルが設定された AWS CLI
• Serverless Framework

インストール手順

npm install

MCP サーバーの設定

テストまたはデプロイする前に、各 MCP サーバーの依存関係をインストールし、ビルドする必要があります。

# 各 MCP サーバーディレクトリに移動して依存関係をインストール
cd mcp_servers/[server-name]
npm install
npm run build

# mcp_servers/ ディレクトリ内の各サーバーディレクトリに対して上記の手順を繰り返します

💻 使用例

基本的な使用法

ローカル開発

Serverless Offline を使用してローカルでサービスを実行します。

npm run dev

Express を使用してより便利にデバッグします。

npm run dev:express

デプロイ

AWS クレデンシャルの設定

デプロイする前に、AWS クレデンシャルが設定されていることを確認してください。

aws configure

MCP サーバーの準備

デプロイする前に、すべての MCP サーバーがビルドされていることを確認してください（MCP サーバーの設定 セクションを参照）。

開発環境へのデプロイ

npm run deploy

これにより、以下のことが行われます：

1. dist ディレクトリをクリーンアップします。
2. TypeScript コードをコンパイルします。
3. MCP サーバーを含む必要なファイルをパッケージ化します。
4. Serverless Framework を使用して AWS にデプロイします。

本番環境へのデプロイ

npm run deploy:prod

高度な使用法

API 使用方法

利用可能なツールの一覧表示

GET /{serverName}

ツールの呼び出し

POST /{serverName}/{toolName}
{
  "param1": "value1",
  "param2": "value2"
}

特定の MCP サーバーの設定に応じて、必要なヘッダー情報を含める必要があります。

📚 ドキュメント

プロジェクト構造

• src/index.ts - メインの Lambda ハンドラー関数
• src/mcp/mcp-server-config.ts - 利用可能な MCP サーバーの設定
• src/mcp/mcp-client-handler.ts - MCP クライアント通信ハンドラー
• mcp_servers/ - MCP サーバーの実装を含むディレクトリ
• serverless.yml - Serverless Framework の設定

スクリプト

• npm run build - TypeScript をコンパイルします。
• npm run watch - TypeScript の変更を監視します。
• npm run clean - dist ディレクトリを削除します。
• npm run dev - ローカルでサービスを実行します。
• npm run deploy - 開発環境にデプロイします。
• npm run deploy:prod - 本番環境にデプロイします。