# JetBrains

Passes MCP client requests into a running JetBrains IDE, so the agent works against the project you have open. Useful when the editor is already running and the client lives outside it.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: gannachernyshova
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gannachernyshova/mcp-jetbrains
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/jetbrains

## What it does

The proxy sits between an MCP client and a JetBrains IDE: the client sends requests, the server hands them to the IDE that holds the project. The IDE itself needs the MCP Server plugin installed, otherwise there is nothing to talk to. Launch it as the `mcp/jetbrains` container or through `npx -y @jetbrains/mcp-proxy`.

When several IDEs are open, set `IDE_PORT` in `env` to pick one. Traffic goes to `127.0.0.1` unless you point `HOST` elsewhere. Logging switches on with `LOG_ENABLED`.

Node 16 is out: startup dies with `Cannot find module 'node:path'`, so use 18 or later. On macOS with nvm the plugin can miss `npx`, and a symlink in `/usr/local/bin` fixes that. External clients and containers such as LibreChat also need external connections allowed in the debugger settings, plus the machine's LAN address in place of `host.docker.internal`.

## Requirements
- Needs: Docker
- Works with: GitHub

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- connect an MCP client to a JetBrains IDE that is already running
- pick one IDE when several windows carry the plugin
- run the proxy in Docker next to a containerised client
- turn on logging when the proxy goes quiet
- trace a startup failure back to an old Node version

## Example prompts
- Hook up my running JetBrains IDE through the MCP proxy and list the tools it exposes.
- The proxy can't see my IDE — check `HOST` and `IDE_PORT` in the config and enable `LOG_ENABLED`.
- Add `npx -y @jetbrains/mcp-proxy` to my MCP client config and wire it to the IDE.

## Similar
- [13-bridge-ide](https://affpapa.org/en/nevibecode/prompts/13-bridge-ide.md) — prompt · ★ 3444 repo stars
- [flexlayout-react](https://affpapa.org/en/nevibecode/skills/flexlayout-react.md) — skill · 345 installs
- [find-agents](https://affpapa.org/en/nevibecode/skills/find-agents.md) — skill · 148 installs
- [kotlin-tooling-agp9-migration](https://affpapa.org/en/nevibecode/skills/kotlin-tooling-agp9-migration.md) — skill · 2500 installs
- [Reado](https://affpapa.org/en/nevibecode/mcp/reado.md) — MCP server · ★ 31 repo stars
- [kotlin-tooling-immutable-collections-0-5-x-migration](https://affpapa.org/en/nevibecode/skills/kotlin-tooling-immutable-collections-0-5-x-migration.md) — skill · 1300 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
