mcp-jetbrains
byjetbrains· 1 MCP server
This repository is no longer maintained. The core functionality has been integrated into all IntelliJ-based IDEs since version 2025.2. The built-in functionality works with SSE and JVM-based proxy (for STDIO) so this NPM package is no longer required.
How to install mcp-jetbrains?
jetbrains/mcp-jetbrains
$git clone https://github.com/jetbrains/mcp-jetbrainsInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install mcp-jetbrains by running `git clone https://github.com/jetbrains/mcp-jetbrains`, then use it for the current task and follow its documentation at https://github.com/jetbrains/mcp-jetbrains.
README.md
| 1 | [](https://github.com/JetBrains#jetbrains-on-github) |
| 2 | |
| 3 | # ⚠️ Deprecated |
| 4 | |
| 5 | **This repository is no longer maintained.** The core functionality has been integrated into all IntelliJ-based IDEs since version 2025.2. |
| 6 | The built-in functionality works with SSE and JVM-based proxy (for STDIO) so this NPM package is no longer required. |
| 7 | |
| 8 | **Migration:** Please refer to the [official documentation](https://www.jetbrains.com/help/idea/mcp-server.html) for details on using the built-in functionality. |
| 9 | |
| 10 | **Issues & Support:** For bugs or feature requests related to the built-in MCP functionality, please use the [JetBrains YouTrack](https://youtrack.jetbrains.com/issues?q=project:%20IJPL%20Subsystem:%20%7BMCP%20(Model%20Context%20Protocol)%7D%20). |
| 11 | |
| 12 | # JetBrains MCP Proxy Server |
| 13 | |
| 14 | The server proxies requests from client to JetBrains IDE. |
| 15 | |
| 16 | ## Install MCP Server plugin |
| 17 | |
| 18 | https://plugins.jetbrains.com/plugin/26071-mcp-server |
| 19 | |
| 20 | ## VS Code Installation |
| 21 | |
| 22 | For one-click installation, click one of the install buttons below: |
| 23 | |
| 24 | [](https://insiders.vscode.dev/redirect/mcp/install?name=jetbrains&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40jetbrains%2Fmcp-proxy%22%5D%7D) [](https://insiders.vscode.dev/redirect/mcp/install?name=jetbrains&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40jetbrains%2Fmcp-proxy%22%5D%7D&quality=insiders) |
| 25 | |
| 26 | ### Manual Installation |
| 27 | |
| 28 | Add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing `Ctrl + Shift + P` and typing `Preferences: Open User Settings (JSON)`. |
| 29 | |
| 30 | ```json |
| 31 | { |
| 32 | "mcp": { |
| 33 | "servers": { |
| 34 | "jetbrains": { |
| 35 | "command": "npx", |
| 36 | "args": ["-y", "@jetbrains/mcp-proxy"] |
| 37 | } |
| 38 | } |
| 39 | } |
| 40 | } |
| 41 | ``` |
| 42 | |
| 43 | Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace: |
| 44 | |
| 45 | ```json |
| 46 | { |
| 47 | "servers": { |
| 48 | "jetbrains": { |
| 49 | "command": "npx", |
| 50 | "args": ["-y", "@jetbrains/mcp-proxy"] |
| 51 | } |
| 52 | } |
| 53 | } |
| 54 | ``` |
| 55 | |
| 56 | ## Usage with Claude Desktop |
| 57 | |
| 58 | To use this with Claude Desktop, add the following to your `claude_desktop_config.json`. |
| 59 | The full path on MacOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`, on Windows: `%APPDATA%/Claude/claude_desktop_config.json`. |
| 60 | |
| 61 | ```json |
| 62 | { |
| 63 | "mcpServers": { |
| 64 | "jetbrains": { |
| 65 | "command": "npx", |
| 66 | "args": ["-y", "@jetbrains/mcp-proxy"] |
| 67 | } |
| 68 | } |
| 69 | } |
| 70 | ``` |
| 71 | |
| 72 | After installing the MCP Server Plugin, and adding the JSON to the config file, restart Claude Desktop, and make sure the Jetbrains product is open before restarting Claude Desktop. |
| 73 | |
| 74 | ## Configuration |
| 75 | |
| 76 | If you're running multiple IDEs with MCP server and want to connect to the specific one, add to the MCP server configuration: |
| 77 | ```json |
| 78 | "env": { |
| 79 | "IDE_PORT": "<port of IDE's built-in webserver>" |
| 80 | } |
| 81 | ``` |
| 82 | |
| 83 | By default, we connect to IDE on 127.0.0.1 but you can specify a different address/host: |
| 84 | ```json |
| 85 | "env": { |
| 86 | "HOST": "<host/address of IDE's built-in webserver>" |
| 87 | } |
| 88 | ``` |
| 89 | |
| 90 | To enable logging add: |
| 91 | ```json |
| 92 | "env": { |
| 93 | "LOG_ENABLED": "true" |
| 94 | } |
| 95 | ``` |
| 96 | |
| 97 | ## Troubleshooting |
| 98 | |
| 99 | ### Node.js Version Requirements |
| 100 | **Problem:** Error message: `Cannot find module 'node:path'` |
| 101 | |
| 102 | **Solution:** |
| 103 | MCP Proxy doesn't work on Node 16. |
| 104 | Upgrade your Node.js installation to version 18 or later. Make sure that `command` in config points to the correct Node.js version. |
| 105 | Try to use the full path to the latest version of NodeJS. |
| 106 | |
| 107 | ### |
| 108 | |
| 109 | ### MacOS: Plugin Unable to Detect Node.js Installed via nvm |
| 110 | **Problem:** On MacOS, if you have Node.js installed through nvm (Node Version Manager), the MCP Server Plugin might be unable to detect your Node.js installation. |
| 111 | |
| 112 | **Solution:** Create a symbolic link in `/usr/local/bin` pointing |
Related
6 picksType
- jcodemunch-mcpToken-efficient code exploration via tree-sitter AST parsing. 70+ languages, 95%+ token savings.Jul 2026
- minimax-coding-plan-mcpSpecialized MiniMax Model Context Protocol (MCP) server designed for coding-plan usersFeb 2026
- neoNeo.mjs is a self-evolving software organism: a professional end-to-end AI engineering team whose cross-model swarm inhabits live apps via Neural Link, Active Hybrid GraphRAG, DreamService, and self-healing loops.Jul 2026
- shadcn-ui-mcp-serverA Model Context Protocol (MCP) server for shadcn/ui components, providing AI assistants with access to component source code, demos, blocks, and metadata.May 2026
- kicad-mcp-proProduction-grade MCP server for KiCad EDA—PCB design, DRC, simulation, BOM, DFM, and manufacturing.Jul 2026
- taiga-ui-mcpModel Context Protocol server providing Taiga UI documentation search and scaffolding tools.Jul 2026
