MCP 代理侧边车

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

该项目扩展了原始 MCP 服务器的功能，增加了 WebSocket 支持，同时保持对原始实现所有功能的兼容性。

架构

graph LR
    A[MCP 客户端<br>例如 Claude<br>桌面应用程序]
    B[MCP 代理<br>侧边车<br>带 WebSocket]
    C[JetBrains IDE]
    D[WebSocket 客户端<br>监控]
    
    A <--MCP 请求/响应--> B
    B <--IDE 命令/响应--> C
    B --WebSocket 通知<br>端口 27042--> D

### 架构图说明
- **A**: 表示 MCP 客户端，例如 Claude 桌面应用程序。
- **B**: 表示 MCP 代理侧边车，具备 WebSocket 功能。
- **C**: 表示 JetBrains IDE。
- **D**: 表示用于监控的 WebSocket 客户端。

## 功能

- **初始 fork**: 来自 @jetbrains/mcp-proxy 的基础实现。
- **WebSocket 支持**: 实现了实时工具调用监控功能。
- **架构清晰**: 保持了原始实现的所有功能，同时扩展了新的特性。

### WebSocket 消息格式
```javascript
interface WindowToFrontend {
    type: 'frontend-ready' | 'backend-ready' | 'proxy-connected';
}

interface ToBackendMessage {
    type: 'initialize' | 'get-configuration' | 'set-configuration';
    data?: unknown;
}

interface ConfigurationKey extends PropertyKey {}

配置选项

使用方法

安装

pnpm install mcp-proxy-sidecar

启动

pnpm start

开发要求

• Node.js: 需要 Node.js 20.x
• 依赖管理: 使用 pnpm (最新版本)

建设步骤

1. 安装依赖:

   pnpm install --frozen-lockfile
   

2. 构建项目:

   pnpm build
   

贡献

1. fork 仓库: 首先 fork 这个仓库。
2. 创建功能分支: 创建你的功能分支（git checkout -b feature/amazing-feature）。
3. 提交更改: 提交你的修改（git commit -m '添加一些神奇的功能'）。
4. 推送到分支: 推送分支到远程仓库（git push origin feature/amazing-feature）。
5. 创建 Pull Request: 提交一个Pull Request。

发布

此包通过 npm 发布，使用以下步骤发布新版本：

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

变更日志

1.0.0

• 初始 fork 自 @jetbrains/mcp-proxy
• 添加 WebSocket 支持，实现实时工具调用监控
• 重命名包以便更清晰
• 更新文档和配置示例

致谢

此项目是 JetBrains MCP Proxy Server 的一个分支。所有原始实现的credits归 JetBrains 团队所有。