mcp-jetbrains
A model context protocol server to work with JetBrains IDEs: IntelliJ, PyCharm, WebStorm, etc. Also, works with Android Studio
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/jetbrains--mcp-jetbrains)HTML
<a href="/listings/jetbrains--mcp-jetbrains"><img src="/api/listings/jetbrains--mcp-jetbrains/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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"]
}
}
}What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 150 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- [](https://github.com/JetBrains#jetbrains-on-github)
- # ⚠️ Deprecated
- **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](https://www.jetbrains.com/help/idea/mcp-server.html) 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](https://youtrack.jetbrains.com/issues?q=project:%20IJPL%20Subsystem:%20%7BMCP%20(Model%20Context%20Protocol)%7D%20).
- # 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
- ## VS Code Installation
- For one-click installation, click one of the install buttons below:
- [](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)
- ### Manual Installation
- 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)`.
- ```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:
- ```json
- {
- "servers": {
- "jetbrains": {
- "command": "npx",
- "args": ["-y", "@jetbrains/mcp-proxy"]
- }
- }
- }
- ```
- ## 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"]
- }
- }
- }
- ```
- 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.
- ## 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": "<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:
- ```json
- "env": {
- "HOST": "<host/address of IDE's built-in webserver>"
- }
- ```
- 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
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.