MCP Gateway

🚀 MCP サーバーゲートウェイ

このサービスゲートウェイは、標準入出力（stdio）ベースのモデルコンテキストプロトコル（MCP）実装（Claude Desktopなど）とHTTP/SSE（Server-Sent Events）ベースのMCPサーバーを橋渡しします。現在、Claude DesktopはstdioベースのMCPサーバーのみをサポートしているため、このゲートウェイによりプロトコル互換性の問題が解決されます。関連する議論はこちらで確認できます。

🚀 クイックスタート

MCPサーバーゲートウェイを使用することで、Claude DesktopがHTTP/SSE MCPサーバーと通信できるようになります。以下の手順に従って、ゲートウェイをインストール、設定してください。

✨ 主な機能

Claude Desktopアプリケーションは現在、stdioベースのMCPサーバープロトコルのみをサポートしていますが、多くのMCPサーバーはHTTPとSSE（Server-Sent Events）の伝送プロトコルを使用しています。このゲートウェイはプロトコル変換器として機能し、Claude Desktopが任意のHTTP/SSE MCPサーバーと通信できるようにします。

1. Claude Desktopからの標準入出力を受け取ります。
2. リクエストを変換し、HTTP/SSE MCPサーバーに転送します。
3. SSEレスポンスをClaude Desktopで使用できる標準入出力形式に変換します。

📦 インストール

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

npm install -g @mcphub/gateway

📚 ドキュメント

1. ゲートウェイのパスを見つける

インストールが完了したら、以下のコマンドを使用して、npmでインストールされたゲートウェイの場所を見つけます。

# グローバルパッケージのルートディレクトリを表示
npm root -g

# ゲートウェイの位置：
<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内のパスを実際に見つけたパスに置き換えてください。

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

ゲートウェイは環境変数を使用して、どのMCPサーバーに接続するかを指定します。

# MCPサーバーURLを設定する（オプション）
export MCP_SERVER_URL=https://your-mcp-server.com/api/mcp

デフォルトでは、ゲートウェイはMCP Hubサーバーhttps://server.mcphub.ai/api/mcpに接続します。このサーバーは、いくつかの事前設定されたMCPサービスへのアクセスを提供します。

4. Claude Desktopを起動する

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

🔧 トラブルシューティング

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

   # すべてのグローバルパッケージをリストし、@mcphub/gatewayを探す
   npm list -g
   
   # または、ゲートウェイを専門的に確認する
   npm list -g @mcphub/gateway
   

2. Node.jsのインストールを検証する：

   # Nodeのバージョンを確認
   node --version
   
   # npmのバージョンを確認
   npm --version
   

3. 一般的な問題：

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

     brew doctor
     brew link node
     

   • 権限エラーが発生した場合は、sudoを使用してインストールする必要がある場合があります。

📄 ライセンス

Apache 2.0 License

サポート

問題が発生した場合や質問がある場合は、GitHubで問題を提出してください。

コントリビューション

コントリビューションを歓迎します！自由にPull Requestを送信してください。