🚀 JetBrains MCP 代理服务器

JetBrains MCP 代理服务器可将客户端请求代理到 JetBrains IDE，为使用 JetBrains IDE 提供便利的代理服务。

🚀 快速开始

✨ 主要特性

• 能够将客户端请求代理到 JetBrains IDE。
• 可与 Claude Desktop 集成使用。
• 支持多种配置选项，如连接特定 IDE、指定地址/主机、启用日志记录等。

📦 安装指南

安装 MCP 服务器插件，可通过以下链接进行安装： https://plugins.jetbrains.com/plugin/26071-mcp-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"]
    }
  }
}

📚 详细文档

配置

• 连接特定 IDE：如果您运行多个 IDE 并希望连接到特定的 IDE，请在 MCP 服务器配置中添加以下内容：

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

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

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

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

"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 上，如果您通过 Node Version Manager (nvm) 安装了 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 的错误。

解决方案：

1. 启用外部连接：在您的 JetBrains IDE 中，启用“Can accept external connections”（可以接受外部连接），路径为 设置 | 构建、执行和部署 | 调试器。
2. 使用 LAN IP 和端口配置：使用计算机的 LAN IP 地址而不是 host.docker.internal，并在配置中明确指定 IDE 的端口和主机地址。示例配置（适用于 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 替换为您计算机的 LAN IP 地址（例如，192.168.0.12）。

如何构建

1. 已在 macOS 上测试过。
2. 使用 brew install node pnpm 安装依赖项。
3. 按照上述步骤进行其他配置。