Public open-source project

MCPxHub

Keeps Claude Desktop and other MCP clients connected to VS Code-family or JetBrains IDE servers as ports change.

Developers connecting MCP clients to VS Code-compatible or JetBrains IDEs.

@bugstan/mcpxhubv1.2.1MITMCPClaudenpm

View on GitHub

Links

Connection guide

Build and release notes

npm package

Requirements

Node.js >= 20
Claude Desktop or another MCP client.
An IDE-side MCP server plugin: GG MCP for VSCode for VS Code/Cursor/Windsurf/Antigravity, or MCP Server Plugin for JetBrains.

Install

shell

npm install -g @bugstan/mcpxhub

shell

npx -y @bugstan/mcpxhub

Configure

json

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

text

Set IDE_TYPE to vscode or jetbrains.

text

Optional env: LOG_ENABLED=true, MCP_SERVER=127.0.0.1, MCP_SERVER_PORT=63342.

Overview

Local bridge between MCP clients and IDE MCP servers.
Discovers active IDE ports and proxies JSON-RPC 2.0 MCP calls locally.
Supports VS Code, Cursor, Windsurf, Antigravity, and JetBrains IDEs.

Common Uses

Connect Claude Desktop to an IDE without manually editing ports.
Keep client configuration stable while IDE MCP server ports change.
Share one bridge across multiple local IDE plugin families.

Documentation

README covers install, environment variables, port ranges, reconnection, and troubleshooting.
Technical guide explains how the bridge finds IDE servers.
Deployment notes cover packaging and publishing your own build.

Next Steps

Install the required IDE plugin first.
Add MCPxHub to Claude Desktop config.
Enable LOG_ENABLED=true when diagnosing connection failures.

Tools / Commands

Start the bridge with npx -y @bugstan/mcpxhub.
From source: npm install, npm run build, node dist/bundle.js.
Local test scripts: ./test.sh [ide_type] on Linux/macOS, test.bat [ide_type] [mcp_server_port] [mcp_server] on Windows.

Resources / Settings

VS Code-family port scan: 9960-9990.
JetBrains port scan: 63342-63352.
Connection priority: MCP_SERVER_PORT, cached endpoint, IDE_TYPE port range, JetBrains fallback.
Adaptive reconnection: 5s polling when disconnected, 30s when stable.

FAQ

Frequently asked questions and troubleshooting guides.

MCPxHub is a local bridge. It scans local ports for active IDE-side MCP servers and proxies RPC calls for clients such as Claude Desktop.

Ensure your IDE plugin (like GG MCP for VS Code) is installed and active. Check that your environment variables (like `IDE_TYPE`) are correct and that the IDE status bar shows it is listening on a port within the scan range.