by JetBrains
Proxies Model Context Protocol requests from external clients to JetBrains IDEs, allowing AI assistants and other tools to interact with the IDE's built‑in capabilities.
JetBrains MCP Proxy Server acts as a bridge between external clients (e.g., VS Code extensions, Claude Desktop, Docker‑based tools) and JetBrains IDEs such as IntelliJ IDEA, PyCharm, WebStorm, Android Studio, etc. It forwards MCP requests to the IDE’s built‑in web server, enabling AI‑driven features without requiring a dedicated plugin inside the IDE.
mcp-server
).npx
:
{
"mcp": {
"servers": {
"jetbrains": {
"command": "npx",
"args": ["-y", "@jetbrains/mcp-proxy"]
}
}
}
}
IDE_PORT
, HOST
, LOG_ENABLED
) to target a specific IDE instance or enable logging.127.0.0.1:63145
), and forward requests.npx
to run the proxy without a global npm install.HOST
and IDE_PORT
.LOG_ENABLED=true
.Q: Which Node version is required? A: Node 18 or newer. Node 16 is not supported.
Q: How do I make the proxy work with nvm on macOS?
A: Create a symlink to the npx
executable in /usr/local/bin
:
which npx &>/dev/null && sudo ln -sf "$(which npx)" /usr/local/bin/npx
Q: My client cannot connect from Docker; what should I do?
A: Enable Can accept external connections in the IDE settings, then set HOST
to your machine’s LAN IP and specify IDE_PORT
.
Q: Is this repository still maintained? A: No. The functionality is now built into IntelliJ‑based IDEs (2025.2+). Use the built‑in MCP support or follow the migration guide.
Q: Where can I report bugs for the built‑in MCP functionality? A: Use JetBrains YouTrack: https://youtrack.jetbrains.com/issues?q=project:%20IJPL%20Subsystem:%20%7BMCP%20(Model%20Context%20Protocol)%7D%20
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.
Migration: Please refer to the official documentation for details on using the built-in functionality.
Issues & Support: For bugs or feature requests related to the built-in MCP functionality, please use the JetBrains YouTrack.
The server proxies requests from client to JetBrains IDE.
https://plugins.jetbrains.com/plugin/26071-mcp-server
For one-click installation, click one of the install buttons below:
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)
.
{
"mcp": {
"servers": {
"jetbrains": {
"command": "npx",
"args": ["-y", "@jetbrains/mcp-proxy"]
}
}
}
}
Optionally, you can add it to a file called .vscode/mcp.json
in your workspace:
{
"servers": {
"jetbrains": {
"command": "npx",
"args": ["-y", "@jetbrains/mcp-proxy"]
}
}
}
To use this with Claude Desktop, add the following to your claude_desktop_config.json
.
The full path on MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
, on Windows: %APPDATA%/Claude/claude_desktop_config.json
.
{
"mcpServers": {
"jetbrains": {
"command": "npx",
"args": ["-y", "@jetbrains/mcp-proxy"]
}
}
}
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.
If you're running multiple IDEs with MCP server and want to connect to the specific one, add to the MCP server configuration:
"env": {
"IDE_PORT": "<port of IDE's built-in webserver>"
}
By default, we connect to IDE on 127.0.0.1 but you can specify a different address/host:
"env": {
"HOST": "<host/address of IDE's built-in webserver>"
}
To enable logging add:
"env": {
"LOG_ENABLED": "true"
}
Problem: Error message: Cannot find module 'node:path'
Solution:
MCP Proxy doesn't work on Node 16.
Upgrade your Node.js installation to version 18 or later. Make sure that command
in config points to the correct Node.js version.
Try to use the full path to the latest version of NodeJS.
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.
Solution: Create a symbolic link in /usr/local/bin
pointing to your nvm npx executable:
which npx &>/dev/null && sudo ln -sf "$(which npx)" /usr/local/bin/npx
This one-liner checks if npx exists in your path and creates the necessary symbolic link with proper permissions.
Problem: When attempting to connect to the JetBrains MCP proxy from external clients, Docker containers, or third-party applications (like LibreChat), requests to endpoints such as http://host.docker.internal:6365/api/mcp/list_tools may return 404 errors or fail to connect. Solution: There are two key issues to address:
In your JetBrains IDE, enable "Can accept external connections" in the Settings | Build, Execution, Deployment | Debugger.
Use your machine's LAN IP address instead of host.docker.internal
Explicitly set the IDE_PORT and HOST in your configuration
Example configuration for LibreChat or similar external clients:
mcpServers:
intellij:
type: stdio
command: sh
args:
- "-c"
- "IDE_PORT=YOUR_IDEA_PORT HOST=YOUR_IDEA_LAN_IP npx -y @jetbrains/mcp-proxy"
Replace:
YOUR_IDEA_PORT
with your IDE's debug port (found in IDE settings)
YOUR_IDEA_LAN_IP
with your computer's local network IP (e.g., 192.168.0.12)
brew install node pnpm
pnpm build
to build the projectPlease log in to share your review and rating for this MCP.
{ "mcpServers": { "jetbrains": { "command": "npx", "args": [ "-y", "@jetbrains/mcp-proxy" ], "env": { "IDE_PORT": "<IDE_PORT>", "HOST": "<HOST>", "LOG_ENABLED": "true" } } } }
Discover more MCP servers with similar functionality and use cases
by zed-industries
Provides real-time collaborative editing powered by Rust, enabling developers to edit code instantly across machines with a responsive, GPU-accelerated UI.
by cline
Provides autonomous coding assistance directly in the IDE, enabling file creation, editing, terminal command execution, browser interactions, and tool extension with user approval at each step.
by continuedev
Provides continuous AI assistance across IDEs, terminals, and CI pipelines, offering agents, chat, inline editing, and autocomplete to accelerate software development.
by github
Enables AI agents, assistants, and chatbots to interact with GitHub via natural‑language commands, providing read‑write access to repositories, issues, pull requests, workflows, security data and team activity.
by block
Automates engineering tasks by installing, executing, editing, and testing code using any large language model, providing end‑to‑end project building, debugging, workflow orchestration, and external API interaction.
by RooCodeInc
An autonomous coding agent that lives inside VS Code, capable of generating, refactoring, debugging code, managing files, running terminal commands, controlling a browser, and adapting its behavior through custom modes and instructions.
by lastmile-ai
A lightweight, composable framework for building AI agents using Model Context Protocol and simple workflow patterns.
by firebase
Provides a command‑line interface to manage, test, and deploy Firebase projects, covering hosting, databases, authentication, cloud functions, extensions, and CI/CD workflows.
by gptme
Empowers large language models to act as personal AI assistants directly inside the terminal, providing capabilities such as code execution, file manipulation, web browsing, vision, and interactive tool usage.