JetBrains MCP Server

⚠️ Tidak Digunakan Lagi

Repositori ini tidak lagi dipelihara. Fungsionalitas inti telah diintegrasikan ke semua IDE berbasis IntelliJ sejak versi 2025.2. Fungsionalitas bawaan bekerja dengan SSE dan proxy berbasis JVM (untuk STDIO) sehingga paket NPM ini tidak lagi diperlukan.

Migrasi: Silakan merujuk ke dokumentasi resmi untuk detail tentang penggunaan fungsionalitas bawaan.

Masalah & Dukungan: Untuk bug atau permintaan fitur terkait fungsionalitas MCP bawaan, silakan gunakan JetBrains YouTrack.

Server Proxy MCP JetBrains

Server ini meneruskan permintaan dari klien ke IDE JetBrains.

Pasang plugin Server MCP

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

Pemasangan VS Code

Untuk pemasangan sekali klik, klik salah satu tombol pasang di bawah ini:

Pemasangan Manual

Tambahkan blok JSON berikut ke berkas Pengaturan Pengguna (JSON) Anda di VS Code. Anda dapat melakukannya dengan menekan Ctrl + Shift + P dan mengetik Preferences: Open User Settings (JSON).

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

Secara opsional, Anda dapat menambahkannya ke berkas bernama .vscode/mcp.json di ruang kerja Anda:

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

Penggunaan dengan Claude Desktop

Untuk menggunakan ini dengan Claude Desktop, tambahkan yang berikut ke claude_desktop_config.json Anda. Jalur lengkap di MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json, di Windows: %APPDATA%/Claude/claude_desktop_config.json.

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

Setelah memasang Plugin Server MCP, dan menambahkan JSON ke berkas konfigurasi, mulai ulang Claude Desktop, dan pastikan produk Jetbrains terbuka sebelum memulai ulang Claude Desktop.

Konfigurasi

Jika Anda menjalankan beberapa IDE dengan server MCP dan ingin terhubung ke yang spesifik, tambahkan ke konfigurasi server MCP:

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

Secara default, kami terhubung ke IDE di 127.0.0.1 tetapi Anda dapat menentukan alamat/host yang berbeda:

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

Untuk mengaktifkan pencatatan, tambahkan:

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

Pemecahan Masalah

Persyaratan Versi Node.js

Masalah: Pesan kesalahan: Cannot find module 'node:path'

Solusi: Proxy MCP tidak berfungsi di Node 16. Tingkatkan instalasi Node.js Anda ke versi 18 atau yang lebih baru. Pastikan bahwa command di konfigurasi menunjuk ke versi Node.js yang benar. Coba gunakan jalur lengkap ke versi terbaru NodeJS.

MacOS: Plugin Tidak Dapat Mendeteksi Node.js yang Dipasang melalui nvm

Masalah: Di MacOS, jika Anda memasang Node.js melalui nvm (Node Version Manager), Plugin Server MCP mungkin tidak dapat mendeteksi instalasi Node.js Anda.

Solusi: Buat tautan simbolik di /usr/local/bin yang menunjuk ke eksekutabel npx nvm Anda:

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

Perintah satu baris ini memeriksa apakah npx ada di jalur Anda dan membuat tautan simbolik yang diperlukan dengan izin yang tepat.

Menggunakan MCP dengan Klien Eksternal atau Kontainer Docker (LibreChat, Cline, dll.)

Masalah: Saat mencoba terhubung ke proxy MCP JetBrains dari klien eksternal, kontainer Docker, atau aplikasi pihak ketiga (seperti LibreChat), permintaan ke titik akhir seperti http://host.docker.internal:6365/api/mcp/list_tools mungkin mengembalikan kesalahan 404 atau gagal terhubung. Solusi: Ada dua masalah utama yang perlu ditangani:

1. Aktifkan Koneksi Eksternal:

Di IDE JetBrains Anda, aktifkan "Can accept external connections" di Settings | Build, Execution, Deployment | Debugger.

2. Konfigurasikan dengan IP LAN dan Port:

Gunakan alamat IP LAN mesin Anda alih-alih host.docker.internal Atur IDE_PORT dan HOST secara eksplisit di konfigurasi Anda Contoh konfigurasi untuk LibreChat atau klien eksternal serupa:

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

Ganti:

YOUR_IDEA_PORT dengan port debug IDE Anda (ditemukan di pengaturan IDE) YOUR_IDEA_LAN_IP dengan IP jaringan lokal komputer Anda (mis., 192.168.0.12)

Cara membangun

1. Diuji di macOS
2. brew install node pnpm
3. Jalankan pnpm build untuk membangun proyek