JetBrains MCP Server

chính thức

Làm việc với mã nguồn của bạn trong các IDE JetBrains

Tài liệu

⚠️ Không còn được dùng nữa

Kho lưu trữ này không còn được bảo trì. Chức năng cốt lõi đã được tích hợp vào tất cả các IDE dựa trên IntelliJ kể từ phiên bản 2025.2. Chức năng tích hợp sẵn hoạt động với SSE và proxy dựa trên JVM (cho STDIO) nên gói NPM này không còn cần thiết nữa.

Di chuyển: Vui lòng tham khảo tài liệu chính thức để biết chi tiết về cách sử dụng chức năng tích hợp sẵn.

Vấn đề & Hỗ trợ: Đối với lỗi hoặc yêu cầu tính năng liên quan đến chức năng MCP tích hợp sẵn, vui lòng sử dụng JetBrains YouTrack.

Máy chủ Proxy MCP JetBrains

Máy chủ này ủy quyền các yêu cầu từ máy khách đến IDE JetBrains.

Cài đặt plugin MCP Server

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

Cài đặt cho VS Code

Để cài đặt một lần nhấp, hãy nhấp vào một trong các nút cài đặt bên dưới:

Cài đặt thủ công

Thêm khối JSON sau vào tệp Cài đặt Người dùng (JSON) trong VS Code. Bạn có thể thực hiện việc này bằng cách nhấn Ctrl + Shift + P và nhập Preferences: Open User Settings (JSON).

{
  "mcp": {
    "servers": {
      "jetbrains": {
        "command": "npx",
        "args": ["-y", "@jetbrains/mcp-proxy"]
      }
    }
  }
}

Tùy chọn, bạn có thể thêm nó vào tệp có tên .vscode/mcp.json trong không gian làm việc của mình:

{
  "servers": {
    "jetbrains": {
      "command": "npx",
      "args": ["-y", "@jetbrains/mcp-proxy"]
    }
  }
}

Sử dụng với Claude Desktop

Để sử dụng với Claude Desktop, hãy thêm phần sau vào claude_desktop_config.json của bạn. Đường dẫn đầy đủ trên MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json, trên Windows: %APPDATA%/Claude/claude_desktop_config.json.

{
  "mcpServers": {
    "jetbrains": {
      "command": "npx",
      "args": ["-y", "@jetbrains/mcp-proxy"]
    }
  }
}

Sau khi cài đặt Plugin MCP Server và thêm JSON vào tệp cấu hình, hãy khởi động lại Claude Desktop và đảm bảo sản phẩm Jetbrains đang mở trước khi khởi động lại Claude Desktop.

Cấu hình

Nếu bạn đang chạy nhiều IDE với máy chủ MCP và muốn kết nối đến một IDE cụ thể, hãy thêm vào cấu hình máy chủ MCP:

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

Theo mặc định, chúng tôi kết nối đến IDE trên 127.0.0.1 nhưng bạn có thể chỉ định một địa chỉ/máy chủ khác:

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

Để bật ghi nhật ký, hãy thêm:

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

Khắc phục sự cố

Yêu cầu phiên bản Node.js

Vấn đề: Thông báo lỗi: Cannot find module 'node:path'

Giải pháp: MCP Proxy không hoạt động trên Node 16. Hãy nâng cấp cài đặt Node.js của bạn lên phiên bản 18 trở lên. Đảm bảo rằng command trong cấu hình trỏ đến đúng phiên bản Node.js. Hãy thử sử dụng đường dẫn đầy đủ đến phiên bản NodeJS mới nhất.

MacOS: Plugin không thể phát hiện Node.js được cài đặt qua nvm

Vấn đề: Trên MacOS, nếu bạn cài đặt Node.js thông qua nvm (Trình quản lý phiên bản Node), Plugin MCP Server có thể không phát hiện được cài đặt Node.js của bạn.

Giải pháp: Tạo một liên kết tượng trưng trong /usr/local/bin trỏ đến tệp thực thi npx của nvm:

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

Lệnh một dòng này kiểm tra xem npx có tồn tại trong đường dẫn của bạn không và tạo liên kết tượng trưng cần thiết với các quyền phù hợp.

Sử dụng MCP với Máy khách Bên ngoài hoặc Vùng chứa Docker (LibreChat, Cline, v.v.)

Vấn đề: Khi cố gắng kết nối đến proxy MCP JetBrains từ các máy khách bên ngoài, vùng chứa Docker hoặc ứng dụng của bên thứ ba (như LibreChat), các yêu cầu đến điểm cuối như http://host.docker.internal:6365/api/mcp/list_tools có thể trả về lỗi 404 hoặc không kết nối được. Giải pháp: Có hai vấn đề chính cần giải quyết:

Bật Kết nối Bên ngoài:

Trong IDE JetBrains của bạn, hãy bật "Có thể chấp nhận kết nối bên ngoài" trong Cài đặt | Xây dựng, Thực thi, Triển khai | Trình gỡ lỗi.

Cấu hình với IP LAN và Cổng:

Sử dụng địa chỉ IP mạng LAN của máy bạn thay vì host.docker.internal Đặt rõ ràng IDE_PORT và HOST trong cấu hình của bạn Ví dụ cấu hình cho LibreChat hoặc các máy khách bên ngoài tương tự:

mcpServers:
  intellij:
    type: stdio
    command: sh
    args:
      - "-c"
      - "IDE_PORT=YOUR_IDEA_PORT HOST=YOUR_IDEA_LAN_IP npx -y @jetbrains/mcp-proxy"

Thay thế:

YOUR_IDEA_PORT bằng cổng gỡ lỗi của IDE (tìm thấy trong cài đặt IDE) YOUR_IDEA_LAN_IP bằng IP mạng cục bộ của máy tính bạn (ví dụ: 192.168.0.12)

Cách xây dựng

Đã kiểm tra trên macOS
brew install node pnpm
Chạy pnpm build để xây dựng dự án