MCP Proxy Sidecar

A fork of JetBrains MCP Server that adds real-time WebSocket monitoring of all MCP interactions

javascript

1

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You run an MCP proxy sidecar that adds WebSocket monitoring to your MCP workflow. It sits between your MCP client and the JetBrains IDE, translating commands and broadcasting every MCP tool call in real time to monitoring clients. This lets you observe exactly which endpoints are invoked, with arguments and timestamps, without changing how you interact with your IDE.

How to use

Install and run the sidecar alongside your MCP client to enable real-time monitoring. Your MCP client connects to the sidecar using standard MCP protocols, while the sidecar forwards commands to the JetBrains IDE and streams tool-call notifications to connected WebSocket clients on port 27042 by default.

To monitor activity, ensure the WebSocket server port is accessible from your monitoring client. You can customize the port with the WS_PORT environment variable when launching the sidecar.

How to install

Prerequisites you need before starting:

Node.js 18+ or 20.x (depending on your setup)
pnpm (latest)

Install and run using the following steps. Each command is on its own line.

How to install

pnpm install --frozen-lockfile
pnpm build

# Run the sidecar via the npm/npx command shown in the configuration example (below) and ensure WS_PORT is set as desired.

Configuration and usage notes

WebSocket port defaults to 27042. Override with WS_PORT in your environment to monitor on a different port.

IDE connection port is auto-scanned across a range when IDE_PORT is not specified. If you do specify IDE_PORT, the sidecar will connect to that exact port for the IDE.

WebSocket message format

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

Available tools

websocket_monitor

Broadcasts MCP tool calls over WebSocket with endpoint, arguments, and timestamp to monitoring clients.

ide_bridge

Translates and forwards MCP commands between the client and the JetBrains IDE.