MCP Proxy Sidecar

MCP プロキシサイドカー

@dortegauによって作成された、WebSocket 監視機能を追加するJetBrains MCP Serverのフォーク。

このプロジェクトは、元の実装のすべての機能との互換性を維持しながら、WebSocket サポートによって元の MCP サーバー機能を拡張します。

建築

上の図は、システム アーキテクチャとデータ フローを示しています。

1. MCPクライアント（Claudeデスクトップアプリなど）は、MCPプロトコルを使用してサイドカーと通信します。
2. サイドカーはコマンドを翻訳し、JetBrains IDEに転送します。
3. IDEからの応答はサイドカーを通じて返される
4. すべてのツール呼び出しは監視目的でWebSocket経由でブロードキャストされます

特徴

このフォークは、WebSocket通知を追加し、すべてのMCPツール呼び出しをリアルタイムで監視できるようにします。各ツール呼び出しは、エンドポイントと引数に関する詳細情報とともにWebSocket経由でブロードキャストされます。

WebSocketメッセージ形式

WebSocketの設定

WebSocketサーバーはデフォルトでポート27042で動作します。このポートは、設定でWS_PORT環境変数を使用してカスタマイズできます。

使用法

MCPサーバープラグインをインストールする

https://plugins.jetbrains.com/plugin/26071-mcp-server

Claude Desktopでの使用

Claude Desktop でこれを使用するには、 claude_desktop_config.jsonに以下の行を追加してください。macOS の場合のフルパスは~/Library/Application\ Support/Claude/claude_desktop_config.json 、Windows の場合のフルパスは%APPDATA%/Claude/claude_desktop_config.json 。

設定オプション

claude_desktop_config.jsonでは次の環境変数を設定できます。

すべてのオプションを含む構成例:

注: IDE_PORTが指定されていない場合、サイドカーはポート 63342 ～ 63352 を自動的にスキャンして IDE を検出します。

発達

要件

• Node.js 20.x
• pnpm（最新バージョン）

建てる

1. 依存関係をインストールします:
   pnpm install --frozen-lockfile
2. プロジェクトをビルドします。
   pnpm build

貢献

1. リポジトリをフォークする
2. 機能ブランチを作成します（ git checkout -b feature/amazing-feature ）
3. 変更をコミットします ( git commit -m 'Add some amazing feature' )
4. ブランチにプッシュする ( git push origin feature/amazing-feature )
5. プルリクエストを開く

出版

このパッケージは次のように npm に公開されます:

• サプライチェーンのセキュリティのために原産地証明を有効化
• 新しいリリースを作成するときにGitHub Actionsを介してリリースを自動化する
• npmレジストリへのパブリックアクセス

新しいバージョンを公開するには:

1. package.json のバージョンを更新する
2. バージョンに一致する新しいタグを作成してプッシュします
3. タグからGitHubリリースを作成する
4. ワークフローは自動的にビルドされ、npmに公開されます。

変更履歴

1.0.0

• @jetbrains/mcp-proxy からの最初のフォーク
• リアルタイムのツール呼び出し監視のためのWebSocketサポートを追加
• わかりやすくするためにパッケージ名を変更しました
• ドキュメントと設定例を更新しました

クレジット

これはJetBrains MCP Proxy Serverのフォークです。オリジナルの実装に関するすべての著作権は JetBrains チームに帰属します。