JetBrains MCP Server

⚠️ Kullanımdan Kaldırıldı

Bu depo artık bakım görmemektedir. Temel işlevsellik, 2025.2 sürümünden itibaren tüm IntelliJ tabanlı IDE'lere entegre edilmiştir. Yerleşik işlevsellik SSE ve JVM tabanlı proxy (STDIO için) ile çalışır, bu nedenle bu NPM paketine artık gerek yoktur.

Geçiş: Yerleşik işlevselliğin kullanımıyla ilgili ayrıntılar için lütfen resmi belgelere bakın.

Sorunlar ve Destek: Yerleşik MCP işlevselliğiyle ilgili hatalar veya özellik istekleri için lütfen JetBrains YouTrack kullanın.

JetBrains MCP Proxy Sunucusu

Sunucu, istemciden JetBrains IDE'ye gelen istekleri yönlendirir.

MCP Sunucu Eklentisini Yükleme

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

VS Code Kurulumu

Tek tıkla kurulum için aşağıdaki kurulum düğmelerinden birine tıklayın:

Manuel Kurulum

VS Code'da Kullanıcı Ayarları (JSON) dosyanıza aşağıdaki JSON bloğunu ekleyin. Bunu Ctrl + Shift + P tuşlarına basıp Preferences: Open User Settings (JSON) yazarak yapabilirsiniz.

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

İsteğe bağlı olarak, çalışma alanınızdaki .vscode/mcp.json adlı bir dosyaya ekleyebilirsiniz:

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

Claude Desktop ile Kullanım

Bunu Claude Desktop ile kullanmak için claude_desktop_config.json dosyanıza aşağıdakini ekleyin. MacOS'ta tam yol: ~/Library/Application\ Support/Claude/claude_desktop_config.json, Windows'ta: %APPDATA%/Claude/claude_desktop_config.json.

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

MCP Sunucu Eklentisini yükledikten ve JSON'u yapılandırma dosyasına ekledikten sonra Claude Desktop'ı yeniden başlatın ve Claude Desktop'ı yeniden başlatmadan önce Jetbrains ürününün açık olduğundan emin olun.

Yapılandırma

MCP sunucusuyla birden fazla IDE çalıştırıyorsanız ve belirli birine bağlanmak istiyorsanız, MCP sunucu yapılandırmasına şunu ekleyin:

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

Varsayılan olarak IDE'ye 127.0.0.1 üzerinden bağlanırız, ancak farklı bir adres/ana bilgisayar belirtebilirsiniz:

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

Günlük kaydını etkinleştirmek için şunu ekleyin:

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

Sorun Giderme

Node.js Sürüm Gereksinimleri

Sorun: Hata mesajı: Cannot find module 'node:path'

Çözüm: MCP Proxy, Node 16'da çalışmaz. Node.js kurulumunuzu sürüm 18 veya sonrasına yükseltin. Yapılandırmadaki command öğesinin doğru Node.js sürümüne işaret ettiğinden emin olun. NodeJS'in en son sürümüne giden tam yolu kullanmayı deneyin.

MacOS: Eklenti nvm ile Kurulu Node.js'i Algılayamıyor

Sorun: MacOS'ta, Node.js nvm (Node Version Manager) aracılığıyla kuruluysa, MCP Sunucu Eklentisi Node.js kurulumunuzu algılayamayabilir.

Çözüm: nvm npx yürütülebilir dosyanıza işaret eden /usr/local/bin içinde sembolik bir bağlantı oluşturun:

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

Bu tek satırlık komut, yolunuzda npx'in var olup olmadığını kontrol eder ve uygun izinlerle gerekli sembolik bağlantıyı oluşturur.

MCP'yi Harici İstemciler veya Docker Konteynerleriyle Kullanma (LibreChat, Cline, vb.)

Sorun: Harici istemcilerden, Docker konteynerlerinden veya üçüncü taraf uygulamalardan (LibreChat gibi) JetBrains MCP proxy'sine bağlanmaya çalışırken, http://host.docker.internal:6365/api/mcp/list_tools gibi uç noktalara yapılan istekler 404 hatası döndürebilir veya bağlanamayabilir. Çözüm: Ele alınması gereken iki önemli konu vardır:

1. Harici Bağlantıları Etkinleştirin:

JetBrains IDE'nizde, Ayarlar | Derleme, Yürütme, Dağıtım | Hata Ayıklayıcı bölümünde "Harici bağlantıları kabul edebilir" seçeneğini etkinleştirin.

2. LAN IP'si ve Bağlantı Noktası ile Yapılandırın:

host.docker.internal yerine makinenizin LAN IP adresini kullanın Yapılandırmanızda IDE_PORT ve HOST'u açıkça ayarlayın LibreChat veya benzer harici istemciler için örnek yapılandırma:

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

Değiştirin:

YOUR_IDEA_PORT IDE'nizin hata ayıklama bağlantı noktasıyla (IDE ayarlarında bulunur) YOUR_IDEA_LAN_IP bilgisayarınızın yerel ağ IP'si ile (örn. 192.168.0.12)

Nasıl Derlenir

1. macOS üzerinde test edilmiştir
2. brew install node pnpm
3. Projeyi derlemek için pnpm build komutunu çalıştırın