JetBrains MCP Proxy Server

by JetBrains

Development/Tools JetBrains Proxy IDE Plugin Communication

The JetBrains MCP Proxy Server proxies requests from a client to a JetBrains IDE. It facilitates communication between external applications and the IDE using the MCP (Machine Code Protocol).

View on GitHub

Last updated: N/A

What is JetBrains MCP Proxy Server?

The JetBrains MCP Proxy Server is a tool that acts as an intermediary between a client application (like Claude Desktop or LibreChat) and a JetBrains IDE. It allows these applications to interact with the IDE by forwarding requests and responses using the Machine Code Protocol.

How to use JetBrains MCP Proxy Server?

Install the MCP Server plugin in your JetBrains IDE.
Configure your client application (e.g., Claude Desktop) to use the proxy server by specifying the command and arguments to run the proxy.
Configure environment variables like IDE_PORT and HOST if you need to connect to a specific IDE instance or a different host.
Address troubleshooting steps for Node.js version issues, MacOS nvm detection, or external client connection problems.

Key features of JetBrains MCP Proxy Server

Proxies requests between client and JetBrains IDE
Supports configuration of IDE port and host
Enables logging for debugging
Facilitates communication with external clients and Docker containers
Provides troubleshooting guidance for common issues

Use cases of JetBrains MCP Proxy Server

Integrating JetBrains IDE with Claude Desktop
Connecting external applications like LibreChat to the IDE
Using the IDE in Docker container environments
Automating tasks within the IDE from external scripts

FAQ from JetBrains MCP Proxy Server

What do I do if I get a 'Cannot find module 'node:path'' error?

This means your Node.js version is too old. Upgrade to Node.js version 18 or later.

What if the MCP Server Plugin can't detect my Node.js installation on MacOS with nvm?

Create a symbolic link in /usr/local/bin pointing to your nvm npx executable using the command: which npx &>/dev/null && sudo ln -sf "$(which npx)" /usr/local/bin/npx

How do I connect to the MCP proxy from external clients or Docker containers?

Enable 'Can accept external connections' in your IDE's Debugger settings.
Use your machine's LAN IP address instead of host.docker.internal.
Explicitly set the IDE_PORT and HOST in your configuration.

How do I enable logging?

Add the following to the MCP server configuration: "env": { "LOG_ENABLED": "true" }

How do I build the project?

Tested on macOS.
brew install node pnpm.
Run pnpm build to build the project.