JetBrains MCP 代理服务器

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

安装 MCP 服务器插件

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

Related MCP server: JetBrains MCP Proxy Server

与 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 服务器运行多个 IDE，并且想要连接到特定的 IDE，请添加到 MCP 服务器配置中：

"env": {
  "IDE_PORT": "<port of IDE's built-in webserver>"
}

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

"env": {
  "HOST": "<host/address of IDE's built-in webserver>"
}

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

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

故障排除

Node.js 版本要求

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

解决方案： MCP Proxy 在 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 错误或连接失败。**解决方案：**有两个关键问题需要解决：

1. 启用外部连接：

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

2. 配置 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）

如何构建

1. 在 macOS 上测试

2. brew install node pnpm

3. 运行pnpm build来构建项目