Jetbrains IDE

🚀 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"]
    }
  }
}

📦 安裝指南

構建項目

若你需要構建該項目，可按以下步驟操作：

1. 此步驟已在 macOS 上測試過。
2. 使用 Homebrew 安裝 node 和 pnpm：

brew install node pnpm

3. 運行以下命令構建項目：

pnpm build

💻 使用示例

配置

連接特定 IDE

如果你運行多個 IDE 並希望連接到特定的 IDE，請在 MCP 服務器配置中添加以下內容：

"env": {
  "IDE_PORT": "<IDE 內置網絡服務器的端口>"
}

指定不同地址/主機

默認情況下，我們連接到 IDE 的地址是 127.0.0.1，但你可以指定不同的地址/主機：

"env": {
  "HOST": "<IDE 內置網絡服務器的主機/地址>"
}

啟用日誌記錄

要啟用日誌記錄，請添加：

"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 錯誤。 解決方案：

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 替換為你計算機的本地網絡 IP 地址（例如 192.168.0.12）。