MCP Kit Local Relay

MCP Kit ローカルリレー

このコマンドラインツールはブリッジとして機能し、Claude Desktop のような標準入力／出力（stdio）を使用するローカル MCP クライアントが、MCP Kit Web アプリで設定したリモート MCP サーバーとやり取りできるようにします。

一度にターゲットサーバー 1 台 へリクエストをプロキシし、そのツールとリソースをローカルで利用できるようにします。

はじめに（Claude Desktop の例）

このリレーを使って Claude Desktop をリモート MCP サーバーに接続するには、次の手順に従ってください。

前提条件：

• Node.js（v18 以降を推奨）
• Node.js
• Git

手順：

1. リレーをクローンする： まだクローンしていない場合は、このリポジトリをクローンし、ディレクトリに移動します。

   git clone https://github.com/trevoruptain/mcp-local-relay
   cd local-relay
   

2. 依存関係をインストールする：

   npm install
   

3. リレーを設定する： local-relay フォルダー内に設定ファイルを 2 つ作成します。

   • .env ファイル： このファイルを作成し、MCP Kit API キーを追加します。API キーはこちらで生成できます。

     # MCP Kit Web アプリ（app.mcpkit.ai）-> API Keys から API キーを取得します
     MCPKIT_API_KEY=your_api_key_here
     

     (your_api_key_here を実際のキーに置き換えてください)

   • mcpconfig.json ファイル： このファイルを作成し、このリレーの接続先にするリモート MCP サーバー 1 台 の一意の ID を指定します。

     {
       "targetServerId": "your_target_server_id_here"
     }
     

     (your_target_server_id_here を MCP Kit Web アプリの Servers ページに表示されているサーバー ID に置き換えてください)

4. リレーをビルドする： コードをコンパイルします。

   npm run build
   

   これにより、必要な JavaScript ファイルを含む dist ディレクトリが作成されます。メインスクリプトは dist/index.js です。

5. Claude Desktop を設定する： リレースクリプトの実行方法を Claude Desktop に指定する必要があります。

   • Claude Desktop の設定を開きます（Menu -> Settings... -> Developer -> Edit Config）。
   • claude_desktop_config.json ファイルを編集します。
   • mcpServers の下にエントリを追加します。command には node を指定し、args にはビルドした dist/index.js ファイルの絶対パスを指定します。

   {
     "mcpServers": {
       "my_mcp_server": {
         // Claude Desktop に表示する名前を選択します
         "command": "node",
         "args": [
           // これを*絶対*パスに置き換えてください！
           "/Users/yourname/path/to/local-relay/dist/index.js"
         ]
       }
     }
   }
   

   • 重要： サンプルのパスを、お使いのシステム上の実際の絶対パスに置き換えてください。
   • Claude の設定ファイルの編集方法について詳しくは、ローカルリレーのドキュメントをご覧ください。(注：最終的な URL が異なる場合は、このリンクを更新してください)

6. Claude Desktop を再起動する： Claude Desktop アプリケーションを完全に終了してから、再起動します。

7. 確認する： Claude Desktop のチャット入力欄にあるハンマーアイコン をクリックします。ターゲットサーバーのツールが、選択した名前（例：my_mcp_server）の下に表示されます。

これで、Claude Desktop 内からリモート MCP サーバーのツールを直接使用できます！

リレーを手動で実行する

ターミナルからリレーを直接実行することもできます（テストや、ほかの stdio クライアントで使用する場合など）。

npm start

このコマンドは node --stack-size=32768 dist/index.js を実行します。リレーは標準入力で MCP コマンドを待ち受けます。--stack-size フラグは、（画像などの）大きなリソースを扱う際に「Maximum call stack size exceeded」エラーが発生する可能性を防ぐために指定されています。

トラブルシューティング

• Claude Desktop の問題：
  • ハンマーアイコンが表示されない、またはツールが一覧に表示されない場合：
  • claude_desktop_config.json 内の dist/index.js の絶対パスを再確認してください。
  • npm run build がエラーなく完了したことを確認してください。
  • .env と mcpconfig.json が local-relay ディレクトリにあり、正しい API キーと Server ID が含まれていることを確認してください。
  • Claude Desktop 自体のログを確認してください（場所については公式の MCP ドキュメントをご覧ください）。
• リレーのエラー：
  • local-relay ディレクトリに作成される local-relay-debug.log ファイルを確認し、リレー自体からの詳細なエラーメッセージを確認してください。
  • .env 内の MCP_SERVER_URL（またはデフォルトの http://localhost:3002）が、稼働中の mcp-kit-server を指していることを確認してください。
  • MCPKIT_API_KEY が有効であることを確認してください。

開発

コードの変更時に自動再起動する開発モードでリレーを実行するには：

npm run dev

これは nodemon と ts-node を使用します。

コントリビューション

コントリビューションを歓迎します！ガイドラインについては CONTRIBUTING.md をご覧ください。

ライセンス

このプロジェクトは MIT ライセンスのもとでライセンスされています。詳細は LICENSE ファイルをご覧ください。