MCP プロキシサイドカー

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

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

建築

graph LR
    A[MCP Client<br>e.g. Claude<br>Desktop App]
    B[MCP Proxy<br>Sidecar<br>with WebSocket]
    C[JetBrains IDE]
    D[WebSocket Clients<br>Monitoring]
    
    A <--MCP requests/responses--> B
    B <--IDE commands/responses--> C
    B --WebSocket notifications<br>port 27042--> D

    style A fill:#f5f5f5,stroke:#333,stroke-width:2px
    style B fill:#e1f5fe,stroke:#333,stroke-width:2px
    style C fill:#f5f5f5,stroke:#333,stroke-width:2px
    style D fill:#f5f5f5,stroke:#333,stroke-width:2px

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

1. MCPクライアント（Claudeデスクトップアプリなど）は、MCPプロトコルを使用してサイドカーと通信します。

2. サイドカーはコマンドを翻訳し、JetBrains IDEに転送します。

3. IDEからの応答はサイドカーを通じて返される

4. すべてのツール呼び出しは監視目的でWebSocket経由でブロードキャストされます

Related MCP server: Shodan MCP Server

特徴

このフォークは、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では次の環境変数を設定できます。

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

{
  "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（最新バージョン）

建てる

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 チームに帰属します。