MCP プロキシサイドカー

npmバージョンライセンス NPMに公開

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

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

建築

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

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

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

Related MCP server: Superset MCP Integration

特徴

このフォークは、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 チームに帰属します。

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Related Resources

Need Help?

Report Issue

MCP Proxy Sidecar