MCPxHub

Connect Claude Desktop to VS Code and JetBrains IDEs to unlock powerful agentic coding capabilities.

MCP x Hub is an advanced middleware bridge designed to connect AI Assistants, such as Claude Desktop, directly to your local development environment. By leveraging the Model Context Protocol (MCP), it enables your AI to read files, execute terminal commands, and analyze code within VS Code (including forks like Cursor, Windsurf, and Antigravity) and the JetBrains suite.

Why MCP x Hub?

While Claude Desktop offers significant reasoning power, it is natively isolated from your local files and tools. MCP x Hub bridges this gap by acting as a secure gateway that auto-discovers running IDE instances and proxies MCP tool calls seamlessly.

• ⚡️ Universal Compatibility: Full support for VS Code, Cursor, Windsurf, and JetBrains IDEs (IntelliJ, PyCharm, WebStorm, etc.).
• 🔌 Zero-Config Connection: Automatically detects active IDE ports without requiring manual IP or port configuration.
• 🛠 Standard-Compliant: Implements MCP JSON-RPC 2.0 for reliable communication and standardized error handling.
• 🔄 Auto-Reconnection: Resilient logic handles IDE restarts automatically, ensuring your AI session remains uninterrupted.
• 🛡 Secure Proxy: All requests are forwarded locally, ensuring your proprietary code data never leaves your machine.

Quick Start Guide

Transform your AI into a coding agent in minutes:

1. Install MCP x Hub

Install the bridge globally via NPM:

npm install -g @bugstan/mcpxhub

2. Install the Required IDE Plugin

You must have the corresponding server plugin active in your IDE:

• VS Code / Cursor / Windsurf: Install ggMCP4VSCode.
• JetBrains: Install the MCP Server Plugin.

3. Configure Claude Desktop

Add the bridge to your claude_desktop_config.json:

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

Note: Set "IDE_TYPE" to "vscode" or "jetbrains" depending on your environment.

4. Start Coding

Launch your IDE first, then open Claude Desktop. The connection will establish automatically.

Core Features

• Smart Discovery: Scans standard port ranges to locate active IDE instances (VS Code: 9960-9990, JetBrains: 63342-63352).
• Parallel Port Scanning: Utilizes high-performance parallel scanning to detect IDEs instantly across large port ranges.
• Live Tool Sync: Automatically detects new tools or capability updates as you modify your IDE environment.
• Adaptive Polling: Includes a robust reconnection mechanism. It polls every 5 seconds when disconnected and switches to 30 seconds when stable to reduce system overhead.
• Resilient Connectivity: Built-in "Wait for IDE" logic allows you to start the bridge and your IDE in any order.

Installation & Development

NPM Installation

# Global installation
npm install -g @bugstan/mcpxhub

# Project dependency
npm install @bugstan/mcpxhub

Troubleshooting

1. Connection Failures: Ensure your IDE is open and the required MCP plugin is active.
2. Firewall Issues: Confirm that your local firewall allows traffic on the specified port ranges (63342-63352 or 9960-9990).
3. Logs: Set LOG_ENABLED=true to see detailed connection attempts and JSON-RPC traffic.
4. JetBrains Default: JetBrains IDEs typically default to port 63342.