MCP Http Proxy

🚀 MCPプロキシ使用ドキュメント

このプロキシスクリプトは、ユーザーがMCP（マイナー制御プロトコル）と統一的なインターフェースでやり取りできるようにすることを目的としています。HTTPを通じて複数のエンドポイントを提供し、GETおよびPOSTリクエストでコマンドを送信し、リアルタイムで応答を受け取ることができます。

🚀 クイックスタート

プロキシの起動

# ターミナルでプロキシスクリプトを実行します
node mcp-proxy.js

コマンドの送信

方法1：POST /rpc/raw/commandを使用する（プログラム的な呼び出しに適しています）

完全なJSON - RPCリクエストをリクエストボディに入れて送信します。

サンプルcurlリクエスト (Linux/macOS):

curl -X POST -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}' \
  http://localhost:3005/rpc/raw/command

サンプルcurlリクエスト (Windowsコマンドプロンプト):

curl -X POST -H "Content-Type: application/json" -d "{\"jsonrpc\":\"2.0\",\"method\":\"tools/list\",\"id\":1}" http://localhost:3005/rpc/raw/command

PowerShellの例：

$rpcBody = @{
    jsonrpc = "2.0"
    method = "tools/call"
    id = 2
    params = @{
        name = "your_tool_name"
        arguments = @{
            param1 = "value1"
            count = 10
        }
    }
} | ConvertTo-Json -Depth 5

Invoke-RestMethod -Uri http://localhost:3005/rpc/raw/command -Method Post -ContentType 'application/json' -Body $rpcBody

方法2：GET /tool/:toolNameを使用する（簡単なGETリクエストに適しています）

URLのクエリパラメータでパラメータを渡します。

サンプルcurlリクエスト：

# 'worker_get'という名前のツールがあり、'name'パラメータを受け取ると仮定します
curl "http://localhost:3005/tool/worker_get?name=my-worker"

リアルタイムイベントのプッシュ

SSEストリーム

GET /sseエンドポイントを通じてServer - Sent Eventsストリームを確立し、サーバーからのリアルタイムメッセージを受け取ることができます。

サンプルcurlリクエスト：

curl http://localhost:3005/sse

デバッグ画面

http://localhost:3005/debugにアクセスすると、以下のようなより詳細なデバッグ情報を見ることができます。

• 現在アクティブなSSE接続の数
• 最近のプロキシログ
• リクエスト履歴
• 生のメッセージ交換記録

✨ 主な機能

1. 子プロセスの起動：プロキシが起動すると、自動的に子プロセスを起動してMCPサービスを実行します。
2. 複数のエンドポイントのサポート：さまざまなリクエストタイプを処理するための複数のHTTPエンドポイントを提供します。
3. パラメータ検証：すべてのユーザー入力に対して厳格なセキュリティチェックを行い、潜在的な攻撃を防止します。
4. エラー処理：問題が発生した場合、適切に処理して分かりやすいエラーメッセージを返します。

📦 インストール

このセクションでは、プロキシを起動するための基本的な手順を説明します。

プロキシの起動

# ターミナルでプロキシスクリプトを実行します
node mcp-proxy.js

💻 使用例

基本的な使用法

# ターミナルでプロキシを起動する
node mcp-proxy.js

高度な使用法

# 複雑なJSON - RPCリクエストを送信する
curl -X POST -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","id":2,"params":{"name":"your_tool_name","arguments":{"param1":"value1","count":10}}}' \
  http://localhost:3005/rpc/raw/command

📚 ドキュメント

エラー処理

プロキシはエラーが発生した場合、できるだけ適切に処理し、分かりやすいフィードバックを提供します。

1. HTTPエラー：標準的なHTTPステータスコードを返します（例：404は未知のツールまたはエンドポイント、400は無効なパラメータ）。
2. パラメータ検証：/tool/:toolNameエンドポイントはクエリパラメータに対して厳格なパターンマッチングチェックを行い、形式エラーはすべてブロックし、詳細なエラーメッセージを返します。
3. MCPエラー：基盤となるMCPプロセスがエラーを返した場合（例：ツールの実行失敗）、プロキシはこれらのエラー情報をキャプチャし、HTTP応答でクライアントに返し、SSEストリームでイベント通知を送信します。

プロキシの停止

プロキシを停止するには、Ctrl + Cを押すか、SIGINT信号を送信します。プロキシは終了する前に以下のクリーンアップ操作を実行します。

1. 子プロセスの終了：MCPWorker.mcpProcess.kill()を呼び出して、実行中のMCPサービスを終了します。
2. 接続の切断：すべてのアクティブなSSEクライアント接続を切断し、リソースが適切に解放されるようにします。

追加機能

MCP管理エンドポイント（オプション）

mcp-manager.jsを有効にすると、プロキシは追加の管理エンドポイントを提供します。

• /mcp/install：新しいMCPインスタンスをインストールします。
• /mcp/start：指定されたMCPサービスを起動します。
• /mcp/stop：実行中のMCPサービスを停止します。
• /mcp/list：すべての利用可能なMCPインスタンスをリストします。

これらの機能により、ユーザーは複数のMCPサービスを動的に管理でき、システムの柔軟性と拡張性が向上します。

セキュリティに関する注意事項

1. 入力検証：プロキシはすべてのユーザー入力に対して厳格な検証を行い、注入攻撃を防止します。
2. アクセス制御：デフォルトでは、すべてのエンドポイントは公開されています。本番環境では、基本認証を設定するか、より高度な認証メカニズムを使用して、機密機能を保護することをお勧めします。
3. ログ記録：詳細なログ記録機能を有効にすることをお勧めします。これにより、監査やトラブルシューティングが容易になります。

ログと監視

プロキシは組み込みのログシステムを提供し、すべてのリクエスト、応答、および内部状態の変化を記録することができます。ログを分析することで、システムの動作状況を効果的に監視し、潜在的な問題を早期に発見することができます。

まとめ

このMCPプロキシは、強力で柔軟なインターフェースを提供し、MCPサービスとのやり取りを簡素化します。簡単なコマンドの実行から複雑なタスクのスケジューリングまで、プロキシはニーズを十分に満たすことができます。提供されているさまざまな機能を適切に構成して使用することで、ユーザーは効率的にマイナーリソースを管理および制御することができます。