MCP プロキシサイドカー

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

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

建築

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

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

特徴

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

WebSocketメッセージ形式

interface MCPNotification {
  type: 'mcp-notification';
  payload: {
    endpoint: string;     // Tool name that was called
    content: any;         // Call arguments
    timestamp: string;    // ISO timestamp
  }
}

WebSocketの設定

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

"env": {
  "WS_PORT": "<custom port number>"  // Example: "8080"
}

使用法

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 。

{
  "mcpServers": {
    "ide": {
      "command": "npx",
      "args": ["-y", "mcp-proxy-sidecar"],
      "env": {
        "WS_PORT": "27042"  // Optional: customize WebSocket port
      }
    }
  }
}

設定オプション

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

変数	説明	デフォルト
`WS_PORT`	WebSocketサーバーのポート	`27042`
`IDE_PORT`	IDE接続用の特定のポート	63342-63352を自動スキャン
`HOST`	IDE接続のホストアドレス	`127.0.0.1`
`LOG_ENABLED`	デバッグログを有効にする	`false`

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

{
  "mcpServers": {
    "ide": {
      "command": "npx",
      "args": ["-y", "mcp-proxy-sidecar"],
      "env": {
        "WS_PORT": "27042",
        "IDE_PORT": "63342",
        "HOST": "127.0.0.1",
        "LOG_ENABLED": "true"
      }
    }
  }
}

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

発達

要件

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

建てる

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

貢献

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

出版

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

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

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

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

変更履歴

1.0.0

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

クレジット

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

MCP Proxy Sidecar

Integrations