Nexus MCP Bridge Server

The Nexus MCP Bridge for VSCode lets Claude Desktop connect securely to your VSCode workspace using the Model Context Protocol. It keeps memory usage low, runs automatically if you configure it to do so, and exposes a controlled set of file-system actions so Claude can read and write files, create directories, and inspect your project while you stay in VSCode.

How to use

Connect Claude Desktop to your VSCode workspace through the Nexus MCP Bridge to perform common editing tasks without leaving your editor. You can read and write files, create directories, and list directory contents while keeping a tight security boundary that only exposes paths you approve. Use the bridge to stay in VSCode, reduce context switching, and monitor the bridge status from the status bar.

How to install

1. Prepare VSCode for MCP bridging by obtaining the Nexus MCP Bridge extension as a VSIX package.
2. In VSCode, install the extension from the VSIX file.
3. Open your VSCode settings and configure the bridge (optional) to tailor startup behavior and accessible paths.
4. Ensure the bridge starts on launch or start it manually from the status bar when needed.

Additional setup and configuration

Configure Claude Desktop to connect through the bridge by adding the MCP server entry that points to the local bridge URL. You also define which actions Claude is allowed to perform, so you keep a tight security boundary.

{
  "mcpServers": {
    "nexus-bridge": {
      "url": "http://localhost:3000/mcp",
      "disabled": false,
      "alwaysAllow": [
        "get_system_info",
        "read_file",
        "write_file",
        "create_directory",
        "list_directory",
        "get_project_status"
      ]
    }
  }
}

Configuration in the VSCode extension

{
  "nexusMcpBridge.port": 3000,
  "nexusMcpBridge.startOnLaunch": true,
  "nexusMcpBridge.allowedPaths": [
    "/path/to/your/project",
    "/path/to/another/project"
  ]
}

Commands

Use the status bar to control the bridge. You can start, stop, or toggle the Nexus MCP Bridge depending on its current state.

Available tools

start_bridge

Start the MCP bridge so Claude Desktop can connect and begin accepting MCP requests.

stop_bridge

Stop the MCP bridge to halt MCP requests from Claude Desktop.

toggle_bridge

Toggle the bridge between active and inactive states from the status bar.

read_file

Allow Claude to read files in permitted workspace paths.

write_file

Allow Claude to write files in permitted workspace paths.

create_directory

Allow Claude to create new directories within permitted workspace paths.

list_directory

Allow Claude to list contents of directories within permitted workspace paths.