MCP Proxy Sidecar logo

MCP Proxy Sidecar

by dortegau

MCP Proxy Sidecar is a fork of the JetBrains MCP Server that enhances it with WebSocket monitoring capabilities. It allows real-time monitoring of MCP tool calls, providing detailed information about endpoints and arguments.

View on GitHub

Last updated: N/A

What is MCP Proxy Sidecar?

The MCP Proxy Sidecar is a proxy server that sits between MCP clients (like Claude Desktop) and a JetBrains IDE. It extends the original JetBrains MCP Server by adding WebSocket support for real-time monitoring of all MCP tool calls.

How to use MCP Proxy Sidecar?

  1. Install the MCP Server Plugin in your JetBrains IDE. 2. Configure your MCP client (e.g., Claude Desktop) to use the MCP Proxy Sidecar, specifying the command to run the sidecar and any necessary environment variables (like WS_PORT). 3. Connect your WebSocket client to the sidecar's WebSocket server (default port 27042) to receive real-time notifications of MCP tool calls.

Key features of MCP Proxy Sidecar

  • WebSocket notifications for real-time tool call monitoring

  • Detailed information about each tool call (endpoint, arguments, timestamp)

  • Customizable WebSocket port via WS_PORT environment variable

  • Compatibility with existing MCP clients and JetBrains IDEs

  • Automatic IDE port scanning if IDE_PORT is not specified

Use cases of MCP Proxy Sidecar

  • Real-time monitoring of MCP tool calls for debugging and analysis

  • Integration with monitoring dashboards and alerting systems

  • Development and testing of MCP clients

  • Auditing and security analysis of MCP communication

FAQ from MCP Proxy Sidecar

What is the default WebSocket port?

The default WebSocket port is 27042.

Can I customize the WebSocket port?

Yes, you can customize the WebSocket port using the WS_PORT environment variable.

What information is included in the WebSocket notifications?

Each notification includes the endpoint (tool name), arguments (content), and a timestamp.

Do I need to specify the IDE port?

No, if IDE_PORT is not specified, the sidecar will automatically scan ports 63342-63352 to find the IDE.

Is this project compatible with the original JetBrains MCP Server?

Yes, this project maintains compatibility with all features of the original implementation.