← Back to directory
J

JetBrains MCP Proxy Server

Official
MCP proxy server to connect JetBrains IDEs
Category
Dev Tools #192 of 438
Stars
★ 962 Popular
Transport
stdio (local process)
Runtime
Node.js 18+
Credentials
No credential needed
License
Apache-2.0
Last commit
⚠
55FMRS · C

JetBrains MCP Proxy Server was an essential tool to connect JetBrains IDEs with MCP clients, but it is now deprecated and users are encouraged to migrate to the built-in MCP functionality. It works well for official JetBrains products but can be complex to configure and troubleshoot.

Strongest · Documentation 14/20 Weakest · Reliability 8/20

Reliability
8/20
Security and permissions
10/20
Maintenance
12/20
Documentation
14/20
Setup experience
11/20
Why each score
Reliability 8/20
The repository is deprecated and core functionality has been integrated into IDE built-in support, but the repository still contains source for the proxy server. The project has build instructions (pnpm build), but no integration tests or CI workflow evidence. The README notes Node 16 issues and suggests Node 18+, but no error handling or edge case details are given. Thus, while the happy path seems plausible, the reliability score is limited by lack of verifiable test coverage and the deprecated status.
Security and permissions 10/20
The server is a proxy that requires access to local IDE and potentially external connections. It allows configuration of HOST and IDE_PORT, which could connect beyond localhost, posing a potential risk. However, there is no evidence of malicious behavior, credential theft, or dangerous remote commands by default. The proxy merely forwards requests and does not handle credentials. Missing explicit permission boundaries and confirmation mechanisms for dangerous operations, so score remains moderate.
Maintenance 12/20
The repository is marked as deprecated and no longer maintained. However, it is still an official JetBrains project with Apache-2.0 license. The integrated functionality has moved to IDE and YouTrack for issue tracking. Since there are no ongoing commits, releases, or dependency updates in this repo, the maintenance score is low, but the license and official ownership exist, giving a moderate score.
Documentation 14/20
The README provides detailed instructions for installation, configuration, and troubleshooting, including examples for VS Code, Claude Desktop, and external clients. It explains how to set environment variables and resolve common issues. However, there is no documentation of tool parameters (the server only proxies, tools are provided by the IDE), and no documentation of limitations or costs. The documentation is incomplete and the repo is deprecated, so score is reduced.
Setup experience 11/20
Setup requires installing the IDE plugin and configuring an MCP client such as VS Code or Claude Desktop. The README provides clear example configurations and troubleshooting steps for Node and macOS. However, since the repo is deprecated, the actual setup may involve using built-in functionality, making the docs somewhat outdated. Due to lack of verifiable execution evidence and the docs targeting a deprecated package, the score is limited.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the network

Best for

  • Developers using JetBrains IDEs who want AI-assisted development
  • Teams that have JetBrains IDEs installed and need AI assistant integration

Not for

  • Developers not using JetBrains IDEs
  • Users needing long-term support or latest features (since deprecated, use built-in IDE functionality)

Required permissions

  • Needs access to the local port of JetBrains IDE (default 127.0.0.1:6365)
  • Requires running npx, so Node.js 18 or later must be installed

Risks and side effects

  • Deprecated and no longer maintained, potential unpatched security vulnerabilities or compatibility issues
  • Requires correct IDE port and host configuration, otherwise connection fails
  • External connections may be needed for third-party clients, posing security risks

Setup

Before you start

Runtime:Node.js 18+

Other optional settings (3)
IDE_PORT optional Port of the IDE's built-in webserver; set this when running multiple IDEs to target a specific one.
HOST optional Host/address of the IDE's built-in webserver; defaults to 127.0.0.1, use your LAN IP for external connections.
LOG_ENABLED optional Set to "true" to enable logging.
  1. Install the MCP Server plugin in your JetBrains IDE (plugin ID: 26071-mcp-server).
  2. Configure your client to run @jetbrains/mcp-proxy via npx. For example, add to Claude Desktop's claude_desktop_config.json:\n``json\n{"mcpServers": {"jetbrains": {"command": "npx", "args": ["-y", "@jetbrains/mcp-proxy"]}}}\n``\n3. Restart the client and ensure the JetBrains IDE is open.
claude_desktop_config.json
{
  "mcpServers": {
    "jetbrains": {
      "command": "npx",
      "args": [
        "-y",
        "@jetbrains/mcp-proxy"
      ]
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

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

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add jetbrains -- npx -y @jetbrains/mcp-proxy

Run it in a terminal; replace any <…> placeholders with your own values first.

Check that it works

Install the MCP Server plugin in your JetBrains IDE, keep the IDE open, restart the client, and confirm the jetbrains server's tools appear in the client's tool list.

Troubleshooting

  1. 1. If you get `Cannot find module 'node:path'`, upgrade Node.js to version 18 or later.
  2. 2. On macOS with nvm, create a symlink: `which npx &>/dev/null && sudo ln -sf "$(which npx)" /usr/local/bin/npx`.
  3. 3. For external clients or Docker, enable 'Can accept external connections' in IDE settings and use LAN IP and port in environment variables.

Things to try

Once connected, you can ask your AI assistant things like:

  • Show the project structure of the project open in my IntelliJ IDE
  • Open and explain this file in my IDE
  • List the run configurations in my IDE
  • Run the tests for the current file in PyCharm

Use cases

Connect AI assistants to JetBrains IDEs for code context
Execute code actions or query project information within the IDE
Integrate JetBrains IDEs with MCP-compatible AI tools

Supported clients

Claude Desktop

Listed from the project's documentation, not tested by this site.

Overview

JetBrains MCP Proxy Server is an official but deprecated proxy server that forwards requests from MCP clients to JetBrains IDEs. It supports IntelliJ, PyCharm, WebStorm, and other IntelliJ-based IDEs, as well as Android Studio. The core functionality has been integrated into all IntelliJ-based IDEs since version 2025.2, making this NPM package no longer required.

Similar servers

Context7 80 · B

Upstash's official server providing up-to-date third-party library docs for AI coding assistants

★ 62.9k · Tools 2 Compare with this →

Source revision c8c2b85bc6f0 Data synced 2026-10-12 Read the FMRS scoring method