MCP Jetbrains

🚀 JetBrains MCP Proxy Server

This server proxies client requests to JetBrains IDEs, providing seamless integration and enhanced functionality.

🚀 Quick Start

📦 Installation of the MCP Server Plugin

You can install the MCP Server plugin from the following link: https://plugins.jetbrains.com/plugin/26071-mcp-server

💻 Usage Examples with Claude Desktop

To use it with Claude Desktop, add the following content to claude_desktop_config.json.

• The full path on MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
• The full path on Windows: %APPDATA%/Claude/claude_desktop_config.json

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

⚙️ Configuration

Connecting to a Specific IDE

If you run multiple IDEs and want to connect to a specific one, add the following to the MCP server configuration:

"env": {
  "IDE_PORT": "<Port of the IDE's built-in web server>"
}

Specifying a Different Address/Host

By default, we connect to the IDE at 127.0.0.1, but you can specify a different address/host:

"env": {
  "HOST": "<Host/Address of the IDE's built-in web server>"
}

Enabling Logging

To enable logging, add:

"env": {
  "LOG_ENABLED": "true"
}

🔧 Troubleshooting

Node.js Version Requirement

Problem: Error message: Cannot find module 'node:path' Solution: The MCP Proxy does not work on Node 16. Upgrade Node.js to version 18 or higher. Ensure that the command in the configuration points to the correct Node.js version. Try using the full path of the latest NodeJS version.

MacOS: Node.js Installed via nvm Not Detected

Problem: On MacOS, if you installed Node.js via Node Version Manager (nvm), the MCP server plugin may not detect your Node.js installation. Solution: Create a symbolic link to /usr/local/bin pointing to your nvm npx executable:

which npx &>/dev/null && sudo ln -sf "$(which npx)" /usr/local/bin/npx

This command checks if npx exists in the path and creates the necessary symbolic link.

Using MCP with External Clients or Docker Containers (e.g., LibreChat, Cline, etc.)

Problem: When trying to connect to the JetBrains MCP proxy from an external client, Docker container, or other third - party applications (e.g., LibreChat), you may encounter an error where you cannot connect to the endpoint http://host.docker.internal:6365/api/mcp/list_tools. Solution:

1. Enable External Connections: In your JetBrains IDE, enable "Can accept external connections" in Settings | Build, Execution, and Deployment | Debugger.
2. Use LAN IP and Port Configuration: Use your computer's LAN IP address instead of host.docker.internal and explicitly specify the IDE's port and host address in the 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 the IDE's debugging port (found in the IDE settings) and YOUR_IDEA_LAN_IP with your computer's LAN IP address (e.g., 192.168.0.12).

🛠️ How to Build

1. It has been tested on macOS.
2. Install dependencies using brew install node pnpm.
3. Follow the above steps for other configurations.