JetBrains MCP Server

官方

使用 JetBrains IDE 處理您的程式碼

GitHub

960

文件

⚠️ 已棄用

此存放庫已不再維護。 核心功能已整合至所有基於 IntelliJ 的 IDE（自 2025.2 版本起）。內建功能可與 SSE 及基於 JVM 的代理（用於 STDIO）搭配使用，因此不再需要此 NPM 套件。

遷移： 請參閱官方文件以了解使用內建功能的詳細資訊。

問題與支援： 若有關於內建 MCP 功能的錯誤或功能請求，請使用 JetBrains YouTrack。

JetBrains MCP 代理伺服器

此伺服器將來自客戶端的請求代理至 JetBrains IDE。

安裝 MCP Server 外掛程式

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 Server 外掛程式並將 JSON 新增至設定檔後，重新啟動 Claude Desktop，並確保在重新啟動 Claude Desktop 前 JetBrains 產品已開啟。

設定

如果您正在執行多個帶有 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 代理無法在 Node 16 上運作。請將您的 Node.js 安裝升級至版本 18 或更新版本。確保設定中的 command 指向正確的 Node.js 版本。請嘗試使用指向最新版本 NodeJS 的完整路徑。

MacOS：外掛程式無法偵測到透過 nvm 安裝的 Node.js

問題： 在 MacOS 上，如果您是透過 nvm（Node 版本管理器）安裝 Node.js，MCP Server 外掛程式可能無法偵測到您的 Node.js 安裝。

解決方案： 在 /usr/local/bin 中建立一個指向您 nvm npx 執行檔的符號連結：

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

此單行指令會檢查 npx 是否存在於您的路徑中，並以適當的權限建立必要的符號連結。

與外部客戶端或 Docker 容器（LibreChat、Cline 等）搭配使用 MCP

問題： 當嘗試從外部客戶端、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 以建置專案