JetBrains

⚠️ Déprécié

Ce dépôt n'est plus maintenu. La fonctionnalité principale a été intégrée dans tous les IDE basés sur IntelliJ depuis la version 2025.2. La fonctionnalité intégrée fonctionne avec SSE et un proxy basé sur JVM (pour STDIO), ce paquet NPM n'est donc plus nécessaire.

Migration : Veuillez consulter la documentation officielle pour plus de détails sur l'utilisation de la fonctionnalité intégrée.

Problèmes & Support : Pour les bogues ou les demandes de fonctionnalités liés à la fonctionnalité MCP intégrée, veuillez utiliser le JetBrains YouTrack.

Serveur Proxy JetBrains MCP

Le serveur relaie les requêtes du client vers l'IDE JetBrains.

Installer le plugin MCP Server

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

Installation VS Code

Pour une installation en un clic, cliquez sur l'un des boutons d'installation ci-dessous :

Installation manuelle

Ajoutez le bloc JSON suivant à votre fichier de paramètres utilisateur (JSON) dans VS Code. Vous pouvez le faire en appuyant sur Ctrl + Shift + P et en tapant Preferences: Open User Settings (JSON).

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

Optionnellement, vous pouvez l'ajouter à un fichier nommé .vscode/mcp.json dans votre espace de travail :

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

Utilisation avec Claude Desktop

Pour l'utiliser avec Claude Desktop, ajoutez ce qui suit à votre claude_desktop_config.json. Le chemin complet sur MacOS : ~/Library/Application\ Support/Claude/claude_desktop_config.json, sur Windows : %APPDATA%/Claude/claude_desktop_config.json.

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

Après avoir installé le plugin MCP Server et ajouté le JSON au fichier de configuration, redémarrez Claude Desktop et assurez-vous que le produit JetBrains est ouvert avant de redémarrer Claude Desktop.

Configuration

Si vous exécutez plusieurs IDE avec le serveur MCP et souhaitez vous connecter à un IDE spécifique, ajoutez à la configuration du serveur MCP :

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

Par défaut, nous nous connectons à l'IDE sur 127.0.0.1, mais vous pouvez spécifier une adresse/hôte différente :

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

Pour activer la journalisation, ajoutez :

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

Dépannage

Exigences de version Node.js

Problème : Message d'erreur : Cannot find module 'node:path'

Solution : Le proxy MCP ne fonctionne pas sur Node 16. Mettez à niveau votre installation Node.js vers la version 18 ou ultérieure. Assurez-vous que command dans la configuration pointe vers la version correcte de Node.js. Essayez d'utiliser le chemin complet vers la dernière version de NodeJS.

MacOS : Le plugin ne parvient pas à détecter Node.js installé via nvm

Problème : Sur MacOS, si Node.js est installé via nvm (Node Version Manager), le plugin MCP Server peut ne pas détecter votre installation Node.js.

Solution : Créez un lien symbolique dans /usr/local/bin pointant vers votre exécutable npx de nvm :

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

Cette commande en une ligne vérifie si npx existe dans votre chemin et crée le lien symbolique nécessaire avec les permissions appropriées.

Utilisation de MCP avec des clients externes ou des conteneurs Docker (LibreChat, Cline, etc.)

Problème : Lors de la tentative de connexion au proxy JetBrains MCP depuis des clients externes, des conteneurs Docker ou des applications tierces (comme LibreChat), les requêtes vers des points de terminaison tels que http://host.docker.internal:6365/api/mcp/list_tools peuvent renvoyer des erreurs 404 ou ne pas se connecter. Solution : Il y a deux problèmes clés à résoudre :

1. Activer les connexions externes :

Dans votre IDE JetBrains, activez « Accepter les connexions externes » dans Paramètres | Build, Execution, Deployment | Debugger.

2. Configurer avec l'IP LAN et le port :

Utilisez l'adresse IP LAN de votre machine au lieu de host.docker.internal Définissez explicitement IDE_PORT et HOST dans votre configuration Exemple de configuration pour LibreChat ou des clients externes similaires :

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

Remplacez :

YOUR_IDEA_PORT par le port de débogage de votre IDE (trouvé dans les paramètres de l'IDE) YOUR_IDEA_LAN_IP par l'IP réseau locale de votre ordinateur (par exemple, 192.168.0.12)

Comment construire

1. Testé sur macOS
2. brew install node pnpm
3. Exécutez pnpm build pour construire le projet