MCP Gateway 236

🚀 MCP ゲートウェイ

MCP ゲートウェイは、クライアントからのリクエストを MCP サーバーに転送するリバースプロキシサーバーです。また、統一されたエントリーポイントを通じて複数の MCP サーバーを利用することも可能です。

✨ 主な機能

• 複数の MCP サーバーをデプロイする
• MCP サーバーに接続する
• ゲートウェイを使用して MCP サーバーを呼び出す
• すべての MCP サーバーの SSE ストリームを取得する
• すべての MCP サーバーのツールを取得する

⚠️ 重要提示

現在、STDIO は supercorp-ai がオープンソースで提供するスーパーゲートウェイに移行しています。当社では後日、この機能を独自に実装する予定です。

📦 インストール

1. GitHub からイメージパッケージを取得する

docker pull ghcr.io/lucky-aeon/mcp-gateway:latest

2. Docker イメージを独自に構築する

docker build -t mcp-gateway .

💻 使用例

基本的な使用法

GitHub から取得した Docker コンテナを実行する：

docker run -d --name mcp-gateway -p 8080:8080 ghcr.io/lucky-aeon/mcp-gateway

独自に構築した Docker イメージを実行する：

docker run -d --name mcp-gateway -p 8080:8080 mcp-gateway

📚 ドキュメント

🔧 MCP サーバーのデプロイ

サポートするコンテンツタイプ：

• application/json
• multipart/form-data
• x-www-form-urlencoded

リクエストパス： POST /api/deploy

リクエストボディの例：

{
  "mcpServers": {
    "server1": {
      "url": "http://example.com/mcp",
      "command": "python3 mcp_server.py"
    },
    "server2": {
      "url": "http://another.example.com/mcp",
      "command": "java -jar mcp.jar"
    }
  }
}

説明：

• url と command は相互に排他的なフィールドで、MCP サーバーの URL または起動コマンドを表します。
• オプションのフィールドには、args（コマンドライン引数を渡すための配列型）と env（環境変数を設定するためのオブジェクト型）があります。

🔧 MCP サーバーの呼び出し

高度な使用法

SSE ストリームの取得：

curl -X GET http://localhost:8080/api/mcp/sse

メソッドの呼び出し：

curl -X POST \
     -H "Content-Type: application/json" \
     -d '{"method": "timeConversion", "params": {"source_time": "12:00", "target_timezone": "Asia/Shanghai"}}' \
     http://localhost:8080/api/mcp/call

🔧 ゲートウェイ機能

高度な使用法

統一エントリーポイントによる呼び出し： すべてのリクエストは /api/mcp/* パスを通じて対応する MCP サーバーに転送され、自動的にクロスドメイン問題が処理されます。

SSE ストリームの処理： ゲートウェイは複数の MCP サーバーの SSE ストリームを統合し、結果にソースサーバーの名前を付けて表示します。

🔧 ツールリストの取得

リクエストパス： GET /api/tools

レスポンスの例：

{
  "tools": [
    {
      "name": "mcpServer1-timeConversion",
      "description": "時間変換ツール",
      "inputSchema": {
        "type": "object",
        "properties": {
          "source_time": {
            "type": "string",
            "description": "元の時間（HH:MM 形式）"
          },
          "target_timezone": {
            "type": "string",
            "description": "目標タイムゾーン"
          }
        },
        "required": ["source_time", "target_timezone"]
      }
    },
    {
      "name": "mcpServer1-timeConvert",
      "description": "時間変換ツール",
      "inputSchema": {
        "type": "object",
        "properties": {
          "source_time": {
            "type": "string",
            "description": "元の時間（HH:MM 形式）"
          },
          "target_timezone": {
            "type": "string",
            "description": "目標タイムゾーン"
          }
        },
        "required": ["source_time", "target_timezone"]
      }
    }
  ]
}

説明：

• ゲートウェイはすべての MCP サーバーのツールリストを自動的に統合し、結果に各ツールが属する MCP サーバーの名前を付けて表示します。
• 入力スキーマは、各ツールの具体的なパラメーター要件を定義しています。

🔧 注意事項

エラー処理

• ゲートウェイはリクエストの合法性をチェックし、統一された形式のエラーメッセージを返します。
• サポートされるエラーコードには、400（無効なリクエスト）、503（サービス利用不可）などがあります。

ログとモニタリング

• ゲートウェイは詳細なアクセスログとヘルス状態のモニタリングを提供します。
• /api/admin/logs を通じて実行ログを確認することができます。

拡張性

• プラグイン方式の拡張をサポートしており、ユーザーは必要に応じてカスタム機能モジュールを追加することができます。
• 豊富な設定オプションを提供しており、ユーザーはゲートウェイの動作をカスタマイズすることができます。