MCP Proxy Server

MCP プロキシサーバー

複数の MCP リソースサーバーを集約し、単一のインターフェースを通じて提供する MCP プロキシサーバーです。このサーバーは、次のことができる中央ハブとして機能します。

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

機能

リソース管理

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

ツールの集約

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

プロンプトの処理

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

設定

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

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

継続的に実行しながら開発する場合：

# Stdio
npm run dev
# SSE
npm run dev:sse

インストール

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 を表示します。