home / mcp / jetbrains mcp proxy server

JetBrains MCP Proxy Server

A model context protocol server to work with JetBrains IDEs: IntelliJ, PyCharm, WebStorm, etc. Also, works with Android Studio

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jetbrains-mcp-jetbrains": {
      "command": "npx",
      "args": [
        "-y",
        "@jetbrains/mcp-proxy"
      ],
      "env": {
        "HOST": "<host/address of IDE's built-in webserver>",
        "IDE_PORT": "<port of IDE's built-in webserver>",
        "LOG_ENABLED": "true"
      }
    }
  }
}

You can use the MCP proxy server to route requests from your external clients or IDEs to JetBrains IDEs, enabling streamlined tooling and remote workflows. This server runs locally and exposes a simple configuration to connect your client or editor to the IDE’s built-in webserver, so you can develop, test, and debug more efficiently.

How to use

You interact with the MCP proxy by running a local process that serves as a bridge between your client (such as an editor or an external app) and the JetBrains IDE. Start the proxy with the configuration shown below, ensuring your IDE is running. The proxy will connect to the IDE on the loopback interface by default and listen for client requests, forwarding them to the IDE and returning responses.

How to install

Prerequisites: ensure you have Node.js installed on your system. You also need npm or another package manager to run the MCP proxy command.

1) Install and run the MCP proxy using npx (this pulls the proxy package and runs it in-place):

npx -y @jetbrains/mcp-proxy

2) Configure your editor or client to use the MCP proxy. The following approach is one-click via VS Code or can be added to your workspace settings.

{
  "mcp": {
    "servers": {
      "jetbrains": {
        "command": "npx",
        "args": ["-y", "@jetbrains/mcp-proxy"]
      }
    }
  }
}

Additional setup for Claude Desktop and IDE connections

If you are using Claude Desktop, add the same server block to your Claude configuration and ensure the JetBrains IDE is open before restarting Claude Desktop.

Example for Claude Desktop configuration file (claude_desktop_config.json):

{
  "mcpServers": {
    "jetbrains": {
      "command": "npx",
      "args": ["-y", "@jetbrains/mcp-proxy"]
    }
  }
}

Available tools

mcp-proxy

The MCP proxy server that forwards requests from clients to the JetBrains IDE and back.

MCP Server Plugin

JetBrains plugin that enables MCP server capabilities within the IDE.