MCP Server Gateway

MCP Server Gateway

Claude Desktop の stdio ベースの Model Context Protocol（MCP）実装と、HTTP/SSE ベースの MCP サーバーをつなぐゲートウェイサービスです。Claude Desktop は現在 stdio ベースの MCP サーバーのみをサポートしているため、このサービスでプロトコルの互換性の問題を解決できます。詳しくはこちらのディスカッションをご覧ください。

このゲートウェイが必要な理由

Claude Desktop アプリは現在、MCP サーバー用に stdio プロトコルのみをサポートしています。一方、多くの MCP サーバーは Server-Sent Events（SSE）トランスポートを使用する HTTP を利用しています。このゲートウェイはプロトコル変換ツールとして機能し、次のようにして Claude Desktop があらゆる HTTP/SSE MCP サーバーと通信できるようにします。

1. Claude Desktop からの stdio 入力を受け付けます
2. リクエストを HTTP/SSE MCP サーバー向けに変換して転送します
3. SSE 応答を Claude Desktop 用の stdio 形式に変換します

インストール

npm を使用してゲートウェイをグローバルにインストールします。

npm install -g @mcphub/gateway

設定

1. ゲートウェイのパスを確認する

インストール後、次のコマンドを使って npm がゲートウェイをインストールした場所を確認します。

# This shows the root directory of global packages
npm root -g

# The gateway will be located at:
<npm_global_root>/@mcphub/gateway/dist/src/mcphub-gateway.js

一般的なグローバルパッケージの保存場所：

• macOS（Homebrew Node）：/opt/homebrew/lib/node_modules/@mcphub/gateway/dist/src/mcphub-gateway.js
• macOS（デフォルト）：/usr/local/lib/node_modules/@mcphub/gateway/dist/src/mcphub-gateway.js
• Windows：%AppData%\npm\node_modules\@mcphub\gateway\dist\src\mcphub-gateway.js

インストールとパスを確認します。

npm list -g @mcphub/gateway

2. Claude Desktop を設定する

Claude Desktop の設定ファイルを新規作成するか、更新します。

macOS の場合

場所：~/Library/Application Support/Claude Desktop/config.json

Windows の場合

場所：%APPDATA%\Claude Desktop\config.json

以下の設定を追加します（手順 1 で確認したパスを使用してください）。

{
  "mcpServers": {
    "server-name": {
      "command": "node",
      "args": ["/opt/homebrew/lib/node_modules/@mcphub/gateway/dist/src/mcphub-gateway.js"]
    }
  }
}

注：args 内のパスを、手順 1 で確認した実際のパスに置き換えてください。

3. MCP サーバー接続を設定する

このゲートウェイでは、接続先の MCP サーバーを環境変数で指定します。

# Set the MCP server URL (optional)
export MCP_SERVER_URL=https://your-mcp-server.com/api/mcp

デフォルトでは、ゲートウェイは https://server.mcphub.ai/api/mcp の MCP Hub サーバーに接続します。このサーバーから、事前設定済みのさまざまな MCP サービスを利用できます。

4. Claude Desktop を起動する

変更を適用するため、Claude Desktop を起動するか再起動します。

トラブルシューティング

1. ゲートウェイのパスが見つからない場合：

   # List all global packages and look for @mcphub/gateway
   npm list -g
   
   # Or specifically check the gateway
   npm list -g @mcphub/gateway
   

2. Node.js のインストールを確認します。

   # Check Node version
   node --version
   
   # Check npm version
   npm --version
   

3. よくある問題：

   • macOS で Homebrew を使用している場合は、Node.js が正しくリンクされていることを確認してください。

     brew doctor
     brew link node
     

   • 権限エラーが発生する場合は、インストール時に sudo の使用が必要になることがあります。

ライセンス

Apache 2.0 ライセンス

サポート

問題が発生した場合や質問がある場合：

• GitHub でイシューを登録してください

貢献

貢献を歓迎します。お気軽に Pull Request を送信してください。