https://github.com/JetBrains/mcpProxy
A model context protocol server to work with JetBrains IDEs: IntelliJ, PyCharm, WebStorm, etc. Also, works with Android Studio
https://github.com/JetBrains/mcpProxy
ide intellij jetbrains mcp mcp-server pycharm
Last synced: 27 days ago
JSON representation
A model context protocol server to work with JetBrains IDEs: IntelliJ, PyCharm, WebStorm, etc. Also, works with Android Studio
- Host: GitHub
- URL: https://github.com/JetBrains/mcpProxy
- Owner: JetBrains
- License: apache-2.0
- Created: 2024-12-09T11:50:21.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-03-26T13:31:11.000Z (about 2 months ago)
- Last Synced: 2025-04-09T11:05:06.785Z (about 1 month ago)
- Topics: ide, intellij, jetbrains, mcp, mcp-server, pycharm
- Language: JavaScript
- Homepage: https://plugins.jetbrains.com/plugin/26071-mcp-server
- Size: 36.1 KB
- Stars: 446
- Watchers: 5
- Forks: 38
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-mcp-servers - JetBrains MCP Proxy - A model context protocol server to work with JetBrains IDEs: IntelliJ, PyCharm, WebStorm, etc. Also, works with Android Studio (Table of Contents / Developer Tools)
- awesome-mcp-zh - JetBrains IDE Proxy
- awesome-mcp-servers - jetbrains/mcpProxy - Connect to JetBrains IDE (Legend / 💻 <a name="developer-tools"></a>Developer Tools)
- awesome-mcp-list - JetBrains/mcpProxy
README
[](https://github.com/JetBrains#jetbrains-on-github)
# JetBrains MCP Proxy Server
The server proxies requests from client to JetBrains IDE.
## Install MCP Server plugin
https://plugins.jetbrains.com/plugin/26071-mcp-server
## Usage with Claude Desktop
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`.
```json
{
"mcpServers": {
"jetbrains": {
"command": "npx",
"args": ["-y", "@jetbrains/mcp-proxy"]
}
}
}
```
## Configuration
If you're running multiple IDEs with MCP server and want to connect to the specific one, add to the MCP server configuration:
```json
"env": {
"IDE_PORT": ""
}
```
By default, we connect to IDE on 127.0.0.1 but you can specify a different address/host:
```json
"env": {
"HOST": ""
}
```
To enable logging add:
```json
"env": {
"LOG_ENABLED": "true"
}
```
## Troubleshooting
### Node.js Version Requirements
**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.
###
### MacOS: Plugin Unable to Detect Node.js Installed via nvm
**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:
```bash
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.
### Using MCP with External Clients or Docker Containers (LibreChat, Cline, etc.)
**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:
1. Enable External Connections:
In your JetBrains IDE, enable "Can accept external connections" in the _Settings | Build, Execution, Deployment | Debugger_.
2. Configure with LAN IP and Port:
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:
```yaml
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)
## How to build
1. Tested on macOS
2. `brew install node pnpm`
3. Run `pnpm build` to build the project