MCP HTTP Wrapper について
MCP HTTP Wrapperは、AWS LambdaのHTTPインターフェースを通じてMCPサーバーを実行します。設定済みのMCPサーバーをデプロイし、そのツールをHTTPエンドポイントとして公開する用途に向いています。
主な機能
- 01AWS LambdaのHTTPラッパー
- 02サーバー名によるツール一覧取得
- 03POSTエンドポイント経由のツール呼び出し
- 04Serverless OfflineまたはExpressでのローカル開発
- 05開発・本番向けデプロイスクリプト
活用シーン
- 01HTTPルート経由でMCPサーバーのツールを公開
- 02ローカルでサービスを実行して開発
- 03ラッパーをAWSにデプロイ
MCP 対応
MCPサーバーの実装をパッケージ化して実行し、MCPクライアントとの通信を処理します。HTTPクライアントはサーバー名とツール名のルートからツールを一覧表示し、呼び出せます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
MCP HTTP ラッパー
Model Context Protocol サーバー用の AWS Lambda HTTP ラッパーです。
前提条件
- Node.js(v18 以降)
- 適切な認証情報で設定された AWS CLI
- Serverless Framework
インストール
npm install
MCP サーバーのセットアップ
テストまたはデプロイの前に、各 MCP サーバーの依存関係をインストールしてビルドする必要があります。
# Navigate to each MCP server directory and install dependencies
cd mcp_servers/[server-name]
npm install
npm run build
# Repeat for each server directory under mcp_servers/
ローカル開発
Serverless Offline を使用してサービスをローカルで実行するには、次のコマンドを実行します。
npm run dev
デバッグを簡単にするため、Express を使用してサービスを実行するには、次のコマンドを実行します。
npm run dev:express
デプロイ
AWS 認証情報の設定
デプロイする前に、AWS 認証情報が設定されていることを確認してください。
aws configure
MCP サーバーの準備
デプロイの前に、すべての MCP サーバーをビルドしてください(MCP サーバーのセットアップのセクションを参照)。
開発環境へのデプロイ
npm run deploy
このコマンドでは、次の処理を行います。
- dist ディレクトリをクリーンアップします
- TypeScript コードをビルドします
- MCP サーバーを含む必要なファイルをパッケージ化します
- 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- 本番環境にデプロイします
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。