MCP Proxy Sidecar
2025.03.23
1
JavaScriptIDE 工具开发辅助工具开发效率
mcp-proxy-sidecar 是一个基于 JetBrains MCP Server 的扩展项目，增加了 WebSocket 监控功能。它作为 MCP 客户端（如 Claude 桌面应用）和 JetBrains IDE 之间的代理，提供实时工具调用监控能力。
View on GitHub
Overview
基本能力
产品定位
mcp-proxy-sidecar 是一个开发工具辅助服务，主要用于增强 JetBrains IDE 与 MCP 客户端之间的通信能力，并提供实时监控功能。
核心功能
- MCP 协议代理：在 MCP 客户端和 JetBrains IDE 之间转发命令和响应
- WebSocket 监控：通过 WebSocket 广播所有工具调用的详细信息
- 自动端口扫描：自动扫描 63342-63352 端口范围寻找 IDE 连接
- 可配置性：支持自定义 WebSocket 端口、IDE 端口、主机地址等
适用场景
- 开发者在 IDE 中使用 MCP 工具时需要实时监控工具调用
- 需要将 MCP 客户端与 JetBrains IDE 连接并增强通信能力的场景
- 开发工具链集成，需要监控和分析 MCP 工具使用情况
工具列表
- WebSocket 监控工具：提供实时工具调用监控能力，可查看调用的端点、参数和时间戳
- MCP 协议代理工具：在 MCP 客户端和 IDE 之间转发命令和响应
常见问题解答
- 如何更改 WebSocket 端口？
通过设置
WS_PORT环境变量来更改默认端口 27042 - 如何指定 IDE 端口？
通过设置
IDE_PORT环境变量来指定，否则会自动扫描 63342-63352 端口范围 - 如何启用调试日志？
设置
LOG_ENABLED环境变量为 "true"
使用教程
使用依赖
- Node.js 20.x
- pnpm (最新版本)
安装教程
- 安装 MCP Server 插件： https://plugins.jetbrains.com/plugin/26071-mcp-server
- 在 Claude Desktop 配置中添加以下内容（MacOS路径：
~/Library/Application\ Support/Claude/claude_desktop_config.json，Windows路径：%APPDATA%/Claude/claude_desktop_config.json）：json { "mcpServers": { "ide": { "command": "npx", "args": ["-y", "mcp-proxy-sidecar"], "env": { "WS_PORT": "27042" } } } }
调试方式
- 启用调试日志：
json "LOG_ENABLED": "true" - 检查 WebSocket 连接： 连接到默认端口 27042 或自定义端口，监听 MCP 工具调用通知
- 检查 IDE 连接： 确保 IDE 正在运行，并且端口配置正确（默认自动扫描 63342-63352）