Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jetbrains--mcp-jetbrains/badge.svg)](/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

i

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)

  1. [![official JetBrains project](http://jb.gg/badges/incubator-flat-square.svg)](https://github.com/JetBrains#jetbrains-on-github)
  2. # ⚠️ Deprecated
  3. **This repository is no longer maintained.** The core functionality has been integrated into all IntelliJ-based IDEs since version 2025.2.
  4. The built-in functionality works with SSE and JVM-based proxy (for STDIO) so this NPM package is no longer required.
  5. **Migration:** Please refer to the [official documentation](https://www.jetbrains.com/help/idea/mcp-server.html) for details on using the built-in functionality.
  6. **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).
  7. # JetBrains MCP Proxy Server
  8. The server proxies requests from client to JetBrains IDE.
  9. ## Install MCP Server plugin
  10. https://plugins.jetbrains.com/plugin/26071-mcp-server
  11. ## VS Code Installation
  12. For one-click installation, click one of the install buttons below:
  13. [![Install with NPX in VS Code](https://img.shields.io/badge/VS_Code-NPM-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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) [![Install with NPX in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-NPM-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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)
  14. ### Manual Installation
  15. 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)`.
  16. ```json
  17. {
  18. "mcp": {
  19. "servers": {
  20. "jetbrains": {
  21. "command": "npx",
  22. "args": ["-y", "@jetbrains/mcp-proxy"]
  23. }
  24. }
  25. }
  26. }
  27. ```
  28. Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace:
  29. ```json
  30. {
  31. "servers": {
  32. "jetbrains": {
  33. "command": "npx",
  34. "args": ["-y", "@jetbrains/mcp-proxy"]
  35. }
  36. }
  37. }
  38. ```
  39. ## Usage with Claude Desktop
  40. To use this with Claude Desktop, add the following to your `claude_desktop_config.json`.
  41. The full path on MacOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`, on Windows: `%APPDATA%/Claude/claude_desktop_config.json`.
  42. ```json
  43. {
  44. "mcpServers": {
  45. "jetbrains": {
  46. "command": "npx",
  47. "args": ["-y", "@jetbrains/mcp-proxy"]
  48. }
  49. }
  50. }
  51. ```
  52. 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.
  53. ## Configuration
  54. If you're running multiple IDEs with MCP server and want to connect to the specific one, add to the MCP server configuration:
  55. ```json
  56. "env": {
  57. "IDE_PORT": "<port of IDE's built-in webserver>"
  58. }
  59. ```
  60. By default, we connect to IDE on 127.0.0.1 but you can specify a different address/host:
  61. ```json
  62. "env": {
  63. "HOST": "<host/address of IDE's built-in webserver>"
  64. }
  65. ```
  66. To enable logging add:
  67. ```json
  68. "env": {
  69. "LOG_ENABLED": "true"
  70. }
  71. ```
  72. ## Troubleshooting
  73. ### Node.js Version Requirements
  74. **Problem:** Error message: `Cannot find module 'node:path'`
  75. **Solution:**
  76. MCP Proxy doesn't work on Node 16.
  77. Upgrade your Node.js installation to version 18 or later. Make sure that `command` in config points to the correct Node.js version.
  78. Try to use the full path to the latest version of NodeJS.
  79. ###
  80. ### MacOS: Plugin Unable to Detect Node.js Installed via nvm
  81. **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.
  82. **Solution:** Create a symbolic link in `/usr/local/bin` pointing to your nvm npx executable:
  83. ```bash
  84. which npx &>/dev/null && sudo ln -sf "$(which npx)" /usr/local/bin/npx
  85. ```
  86. This one-liner checks if npx exists in your path and creates the necessary symbolic link with proper permissions.
  87. ### Using MCP with External Clients or Docker Containers (LibreChat, Cline, etc.)
  88. **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.
  89. **Solution:** There are two key issues to address:
  90. 1. Enable External Connections:
  91. In your JetBrains IDE, enable "Can accept external connections" in the _Settings | Build, Execution, Deployment | Debugger_.
  92. 2. Configure with LAN IP and Port:
  93. Use your machine's LAN IP address instead of `host.docker.internal`
  94. Explicitly set the IDE_PORT and HOST in your configuration
  95. Example configuration for LibreChat or similar external clients:
  96. ```yaml
  97. mcpServers:
  98. intellij:
  99. type: stdio
  100. command: sh
  101. args:
  102. - "-c"
  103. - "IDE_PORT=YOUR_IDEA_PORT HOST=YOUR_IDEA_LAN_IP npx -y @jetbrains/mcp-proxy"
  104. ```
  105. Replace:
  106. `YOUR_IDEA_PORT` with your IDE's debug port (found in IDE settings)
  107. `YOUR_IDEA_LAN_IP` with your computer's local network IP (e.g., 192.168.0.12)
  108. ## How to build
  109. 1. Tested on macOS
  110. 2. `brew install node pnpm`
  111. 3. Run `pnpm build` to build the project

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.