MCPxHub

将 Claude Desktop 连接至 VS Code 与 JetBrains IDE，开启智能代理编程新时代。

MCP x Hub 是一款强大的中间件桥接工具，旨在将 AI 助手（如 Claude Desktop）无缝连接到您的本地开发环境。通过遵循 Model Context Protocol (MCP) 标准，它赋予 AI 直接在 VS Code、Cursor、Windsurf、Antigravity 以及 JetBrains 系列 IDE（IntelliJ, PyCharm, WebStorm 等）中读取文件、执行终端命令和分析代码的能力。

核心优势

虽然 Claude Desktop 功能强大，但它通常与您的本地代码库隔离。MCP x Hub 填补了这一空白。它作为一个智能网关，能够自动发现运行中的 IDE 实例并安全地代理 MCP 工具调用。

• ⚡️ 全面兼容：通过 ggMCP4VSCode 插件支持 VS Code 及其所有派生版本（如 Cursor、Windsurf），同时深度集成 JetBrains 全家桶。
• 🔌 零配置连接：自动检测活动中的 IDE 端口，无需手动编辑 IP 或端口信息。
• 🛠 标准化协议：完整支持 MCP JSON-RPC 2.0，确保可靠的通信与错误处理。
• 🔄 自动重连：具备鲁棒的重连机制，即使 IDE 重启也不会中断 AI 会话。
• 🛡 安全代理：所有请求均在本地转发，确保您的代码数据始终保留在本地机器上。

快速入门指南

只需几分钟，即可让您的 AI 代理开始编程：

1. 安装 MCP x Hub：

   npm install -g @bugstan/mcpxhub
   

2. 安装对应的 IDE 插件：

   • VS Code: 安装 ggMCP4VSCode
   • JetBrains: 安装 MCP Server Plugin

3. 配置 Claude Desktop： 编辑您的 claude_desktop_config.json 文件：

   {
     "mcpServers": {
       "MCPxHub": {
         "command": "npx",
         "args": ["-y", "@bugstan/mcpxhub"],
         "env": {
           "IDE_TYPE": "vscode" // 或者 "jetbrains"
         }
       }
     }
   }
   

4. 开始协作：启动您的 IDE，然后打开 Claude Desktop，两者将自动建立连接。

关键特性

• 智能发现 (Smart Discovery)：自动扫描标准端口范围以查找活动的 IDE 实例（VS Code: 9960-9990，JetBrains: 63342-63352）。
• 并行端口扫描：采用先进的并行扫描技术，即使在较大端口范围内也能瞬间定位 IDE 实例。
• 实时工具同步：当您更新 IDE 插件时，能够实时检测到新的工具或功能。
• 协议合规：实现最新的 MCP JSON-RPC 2.0 规范，确保与 Claude 3.5 Sonnet 等模型的最高兼容性。
• 弹性连接：内置“等待 IDE”逻辑，允许您以任何顺序启动工具或 IDE。

必备 IDE 插件

MCP x Hub 需要在您的 IDE 中安装对应的 MCP 服务插件才能发挥作用：

VS Code 插件

• 插件名称：ggMCP4VSCode
• 功能：在 VS Code 中实现 MCP 服务端，允许通过 MCP x Hub 与 Claude Desktop 进行通信。

JetBrains 插件

• 插件名称：MCP Server Plugin
• 兼容 IDE：IntelliJ IDEA, WebStorm, PyCharm, PhpStorm 等 JetBrains 系列。
• 功能：在 JetBrains IDE 中实现 MCP 服务端，启用 Claude 集成。

安装说明

使用 NPM (推荐)

# 全局安装
npm install -g @bugstan/mcpxhub

# 或作为项目依赖安装
npm install @bugstan/mcpxhub

自动重连机制

MCP x Hub 包含了一套自适应轮询的自动重连机制：

• 启动无序：如果 MCP x Hub 启动时 IDE 尚未运行，程序将持续运行并等待 IDE 启动。
• 自适应轮询：断开连接时每 5 秒 轮询一次（快速响应），连接稳定后每 30 秒 轮询一次（降低开销）。
• 无超时重试：持续尝试连接，确保在 IDE 延迟启动时仍能自动恢复。
• 状态提示：在重连过程中会显示友好的状态信息。

常见问题排查

1. 连接失败：请确保您的 IDE 已启动，并且已安装并启用了相应的 MCP Server 插件。
2. 防火墙拦截：检查防火墙是否允许访问上述指定的端口范围。
3. 调试日志：设置 LOG_ENABLED=true 以查看详细的连接尝试和错误信息。
4. JetBrains 默认值：JetBrains IDE 的默认端口通常为 63342。