home / mcp / jetbrains mcp bridge mcp server

JetBrains MCP Bridge MCP Server

Bridges JetBrains IDE tooling to Cascade Windsurf via MCP enabling seamless IDE tooling integration.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "codecraftingdevelopment-codecraftingdevelopment-mcp-jetbrain": {
      "command": "node",
      "args": [
        "C:/Users/chris/IdeaProjects/test/dist/mcp-server.js"
      ],
      "env": {
        "JETBRAINS_MCP_HOST": "127.0.0.1",
        "JETBRAINS_MCP_PORT": "64342"
      }
    }
  }
}

You can use the JetBrains MCP Bridge to connect JetBrains IDE tooling with Cascade Windsurf through MCP. This bridge lets you access JetBrains tooling inside your MCP workflow, providing a smooth development experience across IDEs and client tools.

How to use

Set up the MCP bridge in your Windsurf environment, then start the local MCP server. From your JetBrains IDE, enable the MCP plugin and connect to the local proxy. Once the proxy is active (default port 64342), Cascade and Windsurf will expose the JetBrains tools through the MCP channel, letting you use IDE features directly in your workflow.

How to install

Prerequisites you need before installation:

JetBrains IDE (IntelliJ, WebStorm, PyCharm, etc.) with the MCP plugin enabled
Node.js >= 18
Windsurf with Cascade

Install dependencies and build the MCP server with the following commands. Run each command on its own line.

npm install
npm run build:mcp

Configuration Windsurf/Cascade

Configure the Windsurf MCP server to point to the JetBrains MCP bridge. Use the following configuration snippet in your Windsurf MCP config file.

{
  "mcpServers": {
    "jetbrains": {
      "command": "node",
      "args": ["C:/Users/chris/IdeaProjects/test/dist/mcp-server.js"],
      "env": {
        "JETBRAINS_MCP_HOST": "127.0.0.1",
        "JETBRAINS_MCP_PORT": "64342"
      }
    }
  }
}

Variables d'environnement

The following environment variables control the JetBrains MCP bridge. You can set them in your shell or within the Windsurf config as shown above.

JETBRAINS_MCP_HOST=127.0.0.1
JETBRAINS_MCP_PORT=64342

Test manuel

You can manually start the MCP bridge with the provided npm script to verify the setup.

npm run start:mcp

Interface Web (optionnel)

If you want a web interface to test the MCP connection, you can run the development server and open the browser to inspect available MCP tools.

npm run dev
```
Open http://localhost:5173 to view the MCP tools.

Available tools

install

Install project dependencies required for the MCP bridge.

build_mcp

Build the MCP bridge bundle used by the local stdio server.

start_mcp

Start the MCP bridge server for local testing and usage.

dev_interface

Run the development web interface to test and inspect MCP tools.