JetBrains MCP Server

⚠️ Veraltet

Dieses Repository wird nicht mehr gepflegt. Die Kernfunktionalität wurde seit Version 2025.2 in alle IntelliJ-basierten IDEs integriert. Die integrierte Funktionalität arbeitet mit SSE und JVM-basiertem Proxy (für STDIO), sodass dieses NPM-Paket nicht mehr benötigt wird.

Migration: Bitte lesen Sie die offizielle Dokumentation für Details zur Nutzung der integrierten Funktionalität.

Probleme & Support: Für Fehler oder Funktionswünsche bezüglich der integrierten MCP-Funktionalität nutzen Sie bitte JetBrains YouTrack.

JetBrains MCP Proxy Server

Der Server leitet Anfragen vom Client an die JetBrains IDE weiter.

MCP Server Plugin installieren

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

VS Code Installation

Für eine Ein-Klick-Installation klicken Sie auf eine der Installationsschaltflächen unten:

Manuelle Installation

Fügen Sie den folgenden JSON-Block zu Ihrer Benutzereinstellungsdatei (JSON) in VS Code hinzu. Dies erreichen Sie durch Drücken von Ctrl + Shift + P und Eingabe von Preferences: Open User Settings (JSON).

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

Optional können Sie es in eine Datei namens .vscode/mcp.json in Ihrem Arbeitsbereich einfügen:

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

Verwendung mit Claude Desktop

Um dies mit Claude Desktop zu verwenden, fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu. Der vollständige Pfad unter MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json, unter Windows: %APPDATA%/Claude/claude_desktop_config.json.

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

Nach der Installation des MCP Server Plugins und dem Hinzufügen des JSON zur Konfigurationsdatei starten Sie Claude Desktop neu und stellen Sie sicher, dass das JetBrains-Produkt geöffnet ist, bevor Sie Claude Desktop neu starten.

Konfiguration

Wenn Sie mehrere IDEs mit MCP-Server betreiben und sich mit einer bestimmten verbinden möchten, fügen Sie der MCP-Server-Konfiguration hinzu:

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

Standardmäßig verbinden wir uns mit der IDE auf 127.0.0.1, aber Sie können eine andere Adresse/einen anderen Host angeben:

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

Um die Protokollierung zu aktivieren, fügen Sie hinzu:

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

Fehlerbehebung

Node.js Versionsanforderungen

Problem: Fehlermeldung: Cannot find module 'node:path'

Lösung: MCP Proxy funktioniert nicht mit Node 16. Aktualisieren Sie Ihre Node.js-Installation auf Version 18 oder höher. Stellen Sie sicher, dass command in der Konfiguration auf die korrekte Node.js-Version verweist. Versuchen Sie, den vollständigen Pfad zur neuesten Version von NodeJS zu verwenden.

MacOS: Plugin kann Node.js nicht erkennen, das über nvm installiert wurde

Problem: Unter MacOS kann das MCP Server Plugin Ihre Node.js-Installation möglicherweise nicht erkennen, wenn Node.js über nvm (Node Version Manager) installiert wurde.

Lösung: Erstellen Sie einen symbolischen Link in /usr/local/bin, der auf Ihre nvm-npx-ausführbare Datei verweist:

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

Dieser Einzeiler prüft, ob npx in Ihrem Pfad existiert, und erstellt den notwendigen symbolischen Link mit den entsprechenden Berechtigungen.

Verwendung von MCP mit externen Clients oder Docker-Containern (LibreChat, Cline, etc.)

Problem: Beim Versuch, sich von externen Clients, Docker-Containern oder Drittanbieteranwendungen (wie LibreChat) mit dem JetBrains MCP-Proxy zu verbinden, können Anfragen an Endpunkte wie http://host.docker.internal:6365/api/mcp/list_tools 404-Fehler zurückgeben oder die Verbindung fehlschlagen. Lösung: Es gibt zwei Hauptprobleme, die zu adressieren sind:

1. Externe Verbindungen aktivieren:

Aktivieren Sie in Ihrer JetBrains IDE „Can accept external connections“ unter Einstellungen | Build, Ausführung, Deployment | Debugger.

2. Mit LAN-IP und Port konfigurieren:

Verwenden Sie die LAN-IP-Adresse Ihres Rechners anstelle von host.docker.internal Setzen Sie IDE_PORT und HOST explizit in Ihrer Konfiguration Beispielkonfiguration für LibreChat oder ähnliche externe Clients:

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

Ersetzen Sie:

YOUR_IDEA_PORT durch den Debug-Port Ihrer IDE (in den IDE-Einstellungen zu finden) YOUR_IDEA_LAN_IP durch die lokale Netzwerk-IP Ihres Computers (z. B. 192.168.0.12)

Bauanleitung

1. Getestet unter macOS
2. brew install node pnpm
3. Führen Sie pnpm build aus, um das Projekt zu bauen