codebridge-mcp

P-de-Jong/codebridge-mcp

3.3

If you are the rightful owner of codebridge-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

CodeBridge MCP transforms your VSCode into a powerful MCP server, enabling seamless AI assistant access to your development environment with intelligent multi-instance coordination.

Tools
9
Resources
0
Prompts
0

CodeBridge MCP

Transform your VSCode into a powerful MCP server - Give AI assistants seamless access to your entire development environment with intelligent multi-instance coordination.

🚀 Quick Setup

1. Install & Auto-Start

  1. Install the CodeBridge MCP extension in VSCode
  2. Extension automatically starts as MCP server on port 9100
  3. Your VSCode is now accessible via MCP! 🎉

2. Connect Your AI Assistant

Claude Code
claude mcp add --transport http codebridge http://localhost:9100/mcp
OpenCode Configuration
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "codebridge-mcp": {
      "type": "local",
      "command": [
        "npx", "mcp-remote", "http://localhost:9100/mcp",
        "--allow-http", "--transport", "http-only"
      ],
      "enabled": true
    }
  }
}
Claude Desktop Configuration
{
  "mcpServers": {
    "codebridge-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote", "http://localhost:9100/mcp",
        "--allow-http", "--transport", "http-only"
      ]
    }
  }
}
Any MCP Client
http://localhost:9100/mcp

✨ Why Choose CodeBridge MCP?

🏗️ Full-Stack Development Made Easy

  • Multi-Instance Support: React frontend (VSCode #1) + Node.js backend (VSCode #2) + Mobile app (VSCode #3) - all accessible through one MCP connection
  • Intelligent Routing: AI automatically knows which workspace to target for each request
  • Live Context: Real-time diagnostics, open files, and editor state - not just static files
  • Zero Setup: Works with your existing VSCode setup, no LSP configuration needed

🤖 AI-Powered Features

  • Real-Time Analysis: AI sees live diagnostics and errors as you code
  • Cross-Project Intelligence: AI understands relationships between frontend/backend code
  • Context-Aware Suggestions: Based on your actual workspace state and current selection
  • Rich Metadata: Symbols, references, definitions - full IDE context for AI

🛠️ Available MCP Tools

  • get_workspaces - Discover all VSCode instances and workspace folders
  • get_diagnostics - Live LSP diagnostics with workspace targeting
  • get_open_files - Open files across all instances (aggregated)
  • get_file_content - File content with workspace-specific routing
  • get_selection - Selected text and context with workspace targeting
  • find_references - Cross-workspace symbol references
  • find_definition - Symbol definitions with workspace routing
  • get_workspace_symbols - Symbol search across all workspaces
  • search_files - File search with workspace filtering

📋 Requirements

  • VSCode 1.80.0+ - The extension runs inside VSCode
  • Node.js 18+ - For MCP client connections (if using npm-based clients)
  • No external dependencies - Everything is self-contained in the extension

Note: The extension creates an HTTP MCP server that any MCP-compatible client can connect to.

⚙️ Extension Settings

Server Configuration

  • codebridge-mcp.server.autoStart: Auto-start MCP server on activation (default: true)
  • codebridge-mcp.server.port: Preferred MCP server port (default: 9100)
  • codebridge-mcp.debug.enableLogging: Debug logging for troubleshooting (default: false)

Multi-Instance Coordination

  • codebridge-mcp.coordination.enabled: Enable multi-instance coordination (default: true)
  • codebridge-mcp.coordination.mode: Force coordination mode - "auto", "master", "worker", "standalone" (default: "auto")
  • codebridge-mcp.coordination.masterPort: Master instance port (default: 9100)
  • codebridge-mcp.coordination.workerPortRange: Worker port range (default: [9101, 9199])

Failover & Reliability

  • codebridge-mcp.failover.enabled: Enable automatic failover (default: true)
  • codebridge-mcp.failover.electionTimeout: Leader election timeout in ms (default: 5000)
  • codebridge-mcp.failover.healthCheckInterval: Health check frequency in ms (default: 3000)

🎛️ Commands

Server Management

  • CodeBridge MCP: Start Server - Start the MCP server
  • CodeBridge MCP: Stop Server - Stop the MCP server
  • CodeBridge MCP: Show Server Status - Display server and workspace info
  • CodeBridge MCP: Toggle Debug Logging - Enable/disable debug logging

Multi-Instance Coordination

  • CodeBridge MCP: Show Coordination Status - Display master/worker status and connections
  • CodeBridge MCP: List Connected Instances - Show all connected VSCode instances
  • CodeBridge MCP: Force Master Mode - Override coordination detection (advanced)
  • CodeBridge MCP: Reset Coordination - Restart coordination system

3. Start Using MCP Tools

// Discover all your workspaces
await client.callTool("get_workspaces", {});

// Get real-time diagnostics from your code
await client.callTool("get_diagnostics", { 
  workspace: "MyProject" 
});

// Access your open files
await client.callTool("get_open_files", {});

// Get your current selection
await client.callTool("get_selection", {});

4. Multi-Instance Setup (Advanced)

Perfect for full-stack development - have separate VSCode instances for frontend, backend, mobile app, etc., all accessible through one MCP connection!

Example workflow:

VSCode #1: React Frontend (port 9100 - Master)
VSCode #2: Node.js Backend (port 9101 - Worker)  
VSCode #3: Mobile App (port 9102 - Worker)

→ AI Assistant connects once to port 9100
→ Gets unified access to all three codebases
→ Can analyze frontend/backend interactions
→ Routes tools to the right project automatically

🏗️ Architecture

Master-Worker Coordination

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   VSCode #1     │    │   VSCode #2     │    │   VSCode #3     │
│   (Master)      │    │   (Worker)      │    │   (Worker)      │
│   Port: 9100    │◄──►│   Port: 9101    │    │   Port: 9102    │
│   ┌───────────┐ │    │   ┌───────────┐ │    │   ┌───────────┐ │
│   │MCP Server │ │    │   │Local Tools│ │    │   │Local Tools│ │
│   │+ Coord    │ │    │   │           │ │    │   │           │ │
│   └───────────┘ │    │   └───────────┘ │    │   └───────────┘ │
└─────────────────┘    └─────────────────┘    └─────────────────┘
         ▲
         │
    ┌────────────┐
    │ MCP Client │ (Always connects to port 9100)
    └────────────┘

Technical Stack

  • Express.js: HTTP server and coordination endpoints
  • @modelcontextprotocol/sdk: Standards-compliant MCP transport
  • VSCode API: Direct access for optimal performance
  • TypeScript: Full type safety and robust error handling
  • Leader Election: Raft-inspired consensus for fault tolerance

🔧 Development

Build and package the extension:

# Install dependencies
bun install

# Build the extension
bun run build

# Package for distribution
bun run package

# Run in development mode
bun run dev

🐛 Troubleshooting

Port Already in Use

If port 9100 is occupied, the extension will automatically find the next available port (9101, 9102, etc.). Check VSCode status bar or run CodeBridge MCP: Show Server Status to see the actual port.

Connection Issues

  1. Ensure VSCode extension is running (CodeBridge MCP: Show Server Status)
  2. Verify the MCP endpoint URL matches your server port
  3. Check firewall settings allow localhost connections
  4. Enable debug logging: CodeBridge MCP: Toggle Debug Logging

Multi-Instance Issues

  • Only connect MCP clients to the master instance (usually port 9100)
  • Use CodeBridge MCP: Show Coordination Status to check master/worker roles
  • Reset coordination if needed: CodeBridge MCP: Reset Coordination
# Install dependencies
bun install

# Build the extension
bun run build

# Package for distribution
bun run package

# Run in development mode
bun run dev

🤝 Contributing

See for technical details and contribution guidelines.