MCP 代理 Sidecar

这是 JetBrains MCP Server 的一个分支，增加了 WebSocket 监控功能，由 @dortegau 创建。

该项目在保持与原始实现的所有功能兼容的同时，通过 WebSocket 支持扩展了原始 MCP 服务器的功能。

架构

graph LR
    A[MCP 客户端<br>例如 Claude<br>桌面应用]
    B[MCP 代理<br>Sidecar<br>带 WebSocket]
    C[JetBrains IDE]
    D[WebSocket 客户端<br>监控]
    
    A <--MCP 请求/响应--> B
    B <--IDE 命令/响应--> C
    B --WebSocket 通知<br>端口 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 协议与 Sidecar 通信
2. Sidecar 转换命令并将其转发到 JetBrains IDE
3. 来自 IDE 的响应通过 Sidecar 发送回去
4. 所有工具调用都通过 WebSocket 广播以进行监控

功能

此分支添加了 WebSocket 通知，允许您实时监控所有 MCP 工具调用。每个工具调用都通过 WebSocket 广播，其中包含有关端点和参数的详细信息。

WebSocket 消息格式

interface MCPNotification {
  type: 'mcp-notification';
  payload: {
    endpoint: string;     // 调用的工具名称
    content: any;         // 调用参数
    timestamp: string;    // ISO 时间戳
  }
}

WebSocket 配置

WebSocket 服务器默认在端口 27042 上运行。您可以使用配置中的 WS_PORT 环境变量自定义此端口：

"env": {
  "WS_PORT": "<自定义端口号>"  // 示例: "8080"
}

用法

安装 MCP Server 插件

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"  // 可选：自定义 WebSocket 端口
      }
    }
  }
}

配置选项

以下环境变量可以在您的 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，则 sidecar 将自动扫描端口 63342-63352 以查找 IDE。

开发

要求

• Node.js 20.x
• pnpm (最新版本)

构建

1. 安装依赖项：

   pnpm install --frozen-lockfile
   

2. 构建项目：

   pnpm build
   

贡献

1. Fork 仓库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

发布

此软件包通过以下方式发布到 npm：

• 启用来源以确保供应链安全
• 通过 GitHub Actions 在创建新版本时自动发布
• 在 npm 注册表上公开访问

要发布新版本：

1. 更新 package.json 中的版本
2. 创建并推送与版本匹配的新标签
3. 从标签创建 GitHub 版本
4. 工作流程将自动构建并发布到 npm

更新日志

1.0.0

• 从 @jetbrains/mcp-proxy 初始 fork
• 增加了 WebSocket 支持，用于实时工具调用监控
• 为了清晰起见，重命名了包
• 更新了文档和配置示例

鸣谢

这是 JetBrains MCP Proxy Server 的一个分支。原始实现的所有功劳归于 JetBrains 团队。