MCP Proxy Server

🚀 MCP 代理サーバー

このサーバーは、複数の MCP リソースサーバーを集約し、単一のインターフェースで提供する代理サーバーです。中心的な役割を果たし、以下のことができます。

• 複数の MCP リソースサーバーに接続して管理する
• 統一されたインターフェースを介してその統合機能を公開する
• リクエストを適切なバックエンドサーバーにルーティングする
• 複数のソースからのレスポンスを集約する

✨ 主な機能

リソース管理

• 複数の MCP リソースサーバーを検出して接続する
• 接続されたすべてのサーバーのリソースを集約する
• サーバー間で一貫した URI スキームを維持する
• リソースのルーティングと解決を処理する

ツール集約

• 接続されたすべてのサーバーのツールを公開する
• ツール呼び出しを適切なバックエンドサーバーにルーティングする
• ツールの状態を維持し、レスポンスを処理する

プロンプト処理

• すべてのサーバーのプロンプトを集約する
• プロンプトリクエストを適切なバックエンドにルーティングする
• 複数サーバーのプロンプトレスポンスを処理する

📦 インストール

Claude Desktop と一緒に使用する場合、サーバーの設定を追加します。

MacOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-proxy": {
      "command": "/path/to/mcp-proxy-server/build/index.js",
      "env": {
        "MCP_CONFIG_PATH": "/absolute/path/to/your/config.json",
        "KEEP_SERVER_OPEN": "1"
      }
    }
  }
}

• KEEP_SERVER_OPEN は、クライアントが切断されたときに SSE を実行し続けます。複数のクライアントが MCP プロキシに接続する場合に便利です。

デバッグ

MCP サーバーは stdio を介して通信するため、デバッグは難しい場合があります。MCP Inspector の使用をおすすめします。これはパッケージスクリプトとして利用できます。

npm run inspector

Inspector は、ブラウザでデバッグツールにアクセスするための URL を提供します。

💻 使用例

基本的な使用法

サーバーを実行するには、JSON 設定ファイルが必要です。このファイルは接続する MCP サーバーを指定します。サンプル設定をコピーし、必要に応じて変更します。

cp config.example.json config.json

サンプル設定の構造：

{
  "servers": [
    {
      "name": "Server 1",
      "transport": {
        "command": "/path/to/server1/build/index.js"
      }
    },
    {
      "name": "Server 2",
      "transport": {
        "command": "server2-command",
        "args": ["--option1", "value1"],
        "env": ["SECRET_API_KEY"]
      }
    },
    {
      "name": "Example Server 3",
      "transport": {
        "type": "sse",
        "url": "http://localhost:8080/sse"
      }
    }
  ]
}

サーバーを実行する際には、設定ファイルを指定する必要があります。

MCP_CONFIG_PATH=./config.json mcp-proxy-server

高度な使用法

開発環境での使用

依存関係をインストールします。

npm install

サーバーをビルドします。

npm run build

自動再構築を伴う開発：

npm run watch

連続実行を伴う開発：

# 標準入出力
npm run dev
# SSE
npm run dev:sse