⚠️ Kullanımdan Kaldırıldı

Bu depo artık bakımı yapılmamaktadır. Temel işlevsellik, sürüm 2025.2'den itibaren tüm IntelliJ tabanlı IDE'lere entegre edilmiştir. Yerleşik işlevsellik SSE ve JVM tabanlı proxy (STDIO için) ile çalışmakta olduğundan bu NPM paketi artık gerekli değildir.

Geçiş: Yerleşik işlevselliği kullanma hakkında ayrıntılar için lütfen resmi dokumentasyona bakınız.

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

JetBrains MCP Proxy Server

Server, istemciden JetBrains IDE'ye istekleri yönlendirir.

MCP Server eklentisini yükleyin

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ız:

Manuel Kurulum

VS Code'daki Kullanıcı Ayarları (JSON) dosyanıza aşağıdaki JSON bloğunu ekleyiniz. 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ızda .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 aşağıdakileri claude_desktop_config.json dosyanıza ekleyiniz. 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 Server Plugin'i yükledikten ve JSON'u config dosyasına ekledikten sonra, Claude Desktop'ı yeniden başlatınız ve Claude Desktop'ı yeniden başlatmadan önce Jetbrains ürününün açık olduğundan emin olunuz.

Yapılandırma

Birden fazla IDE'yi MCP server ile çalıştırıyorsanız ve belirli bir IDE'ye bağlanmak istiyorsanız, MCP server yapılandırmasına ekleyiniz:

"env": {
  "IDE_PORT": "<IDE'nin yerleşik web sunucusunun portu>"
}

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

"env": {
  "HOST": "<IDE'nin yerleşik web sunucusunun host/adresi>"
}

Logging'i etkinleştirmek için ekleyiniz:

"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 daha yeni bir sürüme yükseltin. Config dosyanızdaki command parametresinin doğru Node.js sürümünü işaret ettiğinden emin olun. NodeJS'in en son sürümünün tam yolunu kullanmayı deneyin.

macOS: Eklenti, nvm Aracılığıyla Yüklenen Node.js'i Algılayamıyor

Sorun: macOS'ta nvm (Node Version Manager) aracılığıyla Node.js yüklediyseniz, MCP Server Plugin Node.js kurulumunuzu algılayamayabilir.

Çözüm: /usr/local/bin dizininde nvm npx çalıştırılabilir dosyasını işaret eden bir sembolik bağlantı oluşturunuz:

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

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

Harici Klientler veya Docker Konteynerler ile MCP Kullanımı (LibreChat, Cline, vb.)

Sorun: JetBrains MCP proxy'sine harici klientlerden, Docker konteynerlerinden veya üçüncü taraf uygulamalardan (LibreChat gibi) bağlanmaya çalışırken, http://host.docker.internal:6365/api/mcp/list_tools gibi endpoint'lere gelen istekler 404 hatası döndürebilir veya bağlantı kuramayabilir. Çözüm: Ele alınması gereken iki temel sorun vardır:

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

JetBrains IDE'niz içinde, Settings | Build, Execution, Deployment | Debugger bölümünde "Can accept external connections" seçeneğini etkinleştirin.

2. LAN IP ve Port ile Yapılandırın:

host.docker.internal yerine makinenizin LAN IP adresini kullanınız Yapılandırmada IDE_PORT ve HOST'u açıkça ayarlayınız LibreChat veya benzer harici klientler 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"

Aşağıdakileri değiştirin:

YOUR_IDEA_PORT ile IDE'niz ait debug portunu (IDE ayarlarında bulunur) YOUR_IDEA_LAN_IP ile bilgisayarınızın yerel ağ IP'sini (örneğin, 192.168.0.12)

Derleme Yöntemi

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