🚀 JetBrains MCP 代理服务器
JetBrains MCP 代理服务器可将客户端请求代理到 JetBrains IDE，为相关操作提供便利。
🚀 快速开始
安装 MCP 服务器插件
你可以通过以下链接安装 MCP 服务器插件： https://plugins.jetbrains.com/plugin/26071-mcp-server
使用 Claude 桌面版
若要与 Claude 桌面版一起使用，需在 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"]
}
}
}
📦 安装指南
构建项目
若你需要构建该项目，可按以下步骤操作：
- 此步骤已在 macOS 上测试过。
- 使用 Homebrew 安装
node和pnpm：
brew install node pnpm
- 运行以下命令构建项目：
pnpm build
💻 使用示例
配置
连接特定 IDE
如果你运行多个 IDE 并希望连接到特定的 IDE，请在 MCP 服务器配置中添加以下内容：
"env": {
"IDE_PORT": ""
}
指定不同地址/主机
默认情况下，我们连接到 IDE 的地址是 127.0.0.1，但你可以指定不同的地址/主机：
"env": {
"HOST": ""
}
启用日志记录
要启用日志记录，请添加：
"env": {
"LOG_ENABLED": "true"
}
🔧 技术细节
故障排除
Node.js 版本要求
问题：错误信息为 无法找到模块 'node:path'。
解决方案：MCP Proxy 在 Node.js 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 中，启用 "设置 | 构建、执行、调试 | 调试器" 中的 "Can accept external connections"（可以接受外部连接）。
- 使用 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 替换为你计算机的本地网络 IP 地址（例如 192.168.0.12）。