JetBrains MCP 代理服务器

该服务器将客户端的请求代理到 JetBrains IDE。

安装 MCP 服务器插件

https://plugins.jetbrains.com/plugin/26071-mcp-server

VS Code 安装

要一键安装，请点击以下安装按钮之一：

手动安装

将以下 JSON 块添加到 VS Code 的用户设置（JSON）文件中。你可以通过按 Ctrl + Shift + P 并输入 Preferences: Open User Settings (JSON) 来执行此操作。

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

你也可以选择将其添加到工作区中名为 .vscode/mcp.json 的文件中：

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

与 Claude Desktop 一起使用

要与 Claude Desktop 一起使用，请将以下内容添加到你的 claude_desktop_config.json 中。
在 MacOS 上的完整路径为：~/Library/Application\ Support/Claude/claude_desktop_config.json，在 Windows 上为：%APPDATA%/Claude/claude_desktop_config.json。

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

安装 MCP 服务器插件并将 JSON 添加到配置文件后，重新启动 Claude Desktop，并确保在重新启动 Claude Desktop 之前打开 JetBrains 产品。

配置

如果你正在运行多个带有 MCP 服务器的 IDE 并希望连接到特定的 IDE，请添加到 MCP 服务器配置中：

"env": {
  "IDE_PORT": "<IDE 内置 Web 服务器的端口>"
}

默认情况下，我们连接到 127.0.0.1 上的 IDE，但你可以指定不同的地址/主机：

"env": {
  "HOST": "<IDE 内置 Web 服务器的主机/地址>"
}

要启用日志记录，请添加：

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

故障排除

Node.js 版本要求

问题： 错误消息：Cannot find module 'node:path'

解决方案：
MCP 代理在 Node 16 上无法工作。
将你的 Node.js 安装升级到版本 18 或更高版本。确保配置中的 command 指向正确的 Node.js 版本。
尝试使用最新版本 NodeJS 的完整路径。

MacOS：插件无法检测通过 nvm 安装的 Node.js

问题： 在 MacOS 上，如果你通过 nvm（Node 版本管理器）安装了 Node.js，MCP 服务器插件可能无法检测到你的 Node.js 安装。

解决方案： 在 /usr/local/bin 中创建一个指向你的 nvm npx 可执行文件的符号链接：

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

这个单行命令会检查 npx 是否存在于你的路径中，并使用适当的权限创建必要的符号链接。

将 MCP 与外部客户端或 Docker 容器（LibreChat、Cline 等）一起使用

问题： 当尝试从外部客户端、Docker 容器或第三方应用程序（如 LibreChat）连接到 JetBrains MCP 代理时，对诸如 http://host.docker.internal:6365/api/mcp/list_tools 等端点的请求可能会返回 404 错误或无法连接。
解决方案： 有两个关键问题需要解决：

启用外部连接：

在你的 JetBrains IDE 中，在 设置 | 构建、执行、部署 | 调试器 中启用“可以接受外部连接”。

使用 LAN IP 和端口进行配置：

使用你机器的 LAN IP 地址而不是 host.docker.internal
在配置中显式设置 IDE_PORT 和 HOST
例如，为 LibreChat 或类似的外部客户端配置：

mcpServers:
  intellij:
    type: stdio
    command: sh
    args:
      - "-c"
      - "IDE_PORT=YOUR_IDEA_PORT HOST=YOUR_IDEA_LAN_IP npx -y @jetbrains/mcp-proxy"

替换：

YOUR_IDEA_PORT 为你的 IDE 调试端口（在 IDE 设置中找到）
YOUR_IDEA_LAN_IP 为你计算机的本地网络 IP（例如，192.168.0.12）

如何构建

在 macOS 上测试
brew install node pnpm
运行 pnpm build 来构建项目