MCP Proxy Sidecar

🚀 MCP 代理侧边车

MCP 代理侧边车是由 @dortegau 创建的 JetBrains MCP Server 的一个分支，它扩展了原始 MCP 服务器的功能，添加了 WebSocket 监控功能，同时保持对原始实现所有功能的兼容性，可用于实时监控工具调用情况。

🚀 快速开始

安装

pnpm install mcp-proxy-sidecar

启动

pnpm start

✨ 主要特性

• 初始 fork：基于 @jetbrains/mcp-proxy 的基础实现。
• 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 客户端。

WebSocket 消息格式

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 的一个分支。所有原始实现的功劳归 JetBrains 团队所有。

📄 许可证

本项目采用 Apache 2.0 许可证。