JetBrains MCP Proxy : dès 2025.2, l'intégration native ; ce paquet seulement pour les anciennes IDE

À qui ça s'adresse

Pour qui utilise encore une ancienne IDE JetBrains et doit proxifier les requêtes d'un client MCP vers l'IDE. Les preuves indiquent : ce serveur proxifie les requêtes client vers une IDE JetBrains.

Mais ce dépôt n'est plus maintenu. La capacité centrale est intégrée depuis 2025.2 dans toutes les IDE basées sur IntelliJ : SSE intégré, plus un proxy JVM pour STDIO, donc ce paquet NPM n'est plus nécessaire. Si l'IDE est déjà 2025.2 ou plus récente, n'installe pas ce paquet.

Continue seulement si tu as encore explicitement besoin du chemin NPM historique. Il faut aussi le plugin MCP Server, et Node.js doit être 18 ou plus. Les preuves ne listent pas les produits clients ; le périmètre s'arrête à « JetBrains IDE ».

Premier essai en 3 minutes

Si IDE ≥ 2025.2 : le chemin principal est le MCP intégré de l'IDE (SSE / proxy JVM STDIO). Arrête-toi là ; n'exécute pas le npx ci-dessous.

Si tu utilises encore ce paquet, configure :

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

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

Prérequis : l'IDE est ouverte ; le plugin est installé ; Node 18+ (Node 16 lève Cannot find module 'node:path'). Le proxy se connecte par défaut à l'IDE sur 127.0.0.1 et touche l'IDE et le projet locaux — ce n'est pas un montage sans lecture locale.

Emplacement : command / args du MCP client. Si plusieurs IDE sont ouvertes, ajoute aussi :

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

Premier appel à faible risque : une requête de connectivité, pour que le client demande via le proxy des infos en lecture seule sur le projet actuel (par exemple quel projet est ouvert). Les preuves ne nomment ni outils ni paramètres. Ne commence pas par modifier des fichiers, lancer un build ou faire des écritures IDE.

Signal de succès : le processus proxy démarre, le client ne signale plus qu'il n'atteint pas l'IDE ; avec plusieurs IDE, IDE_PORT pointe vers celle que tu as choisie. Si ce n'est toujours pas la bonne instance, change d'abord le port ; ne suppose pas que le défaut est correct.

Cas d'usage

Cas 1 : brancher un client MCP sur une seule IDE en cours d'exécution. Utilise le 127.0.0.1 par défaut et la config npx ci-dessus (ou l'intégration 2025.2+). Les preuves garantissent seulement « proxifier les requêtes vers l'IDE » et ne listent pas les outils. Tu confirmes : la requête a atteint l'IDE locale.

Cas 2 : plusieurs IDE avec MCP sont ouvertes, et tu veux en figer une. Ajoute IDE_PORT dans la config. Les preuves disent aussi qu'on peut spécifier un autre address/host, mais le locator est tronqué à « specify a different address/host: » et ne donne pas le nom de variable d'environnement. Seul IDE_PORT est une méthode de choix confirmée ; n'invente pas de variable host.

Limites d'usage

Le dépôt n'est plus maintenu ; dès 2025.2+, utilise la capacité intégrée. Le chemin historique dépend de @jetbrains/mcp-proxy, du plugin MCP Server et de Node 18+. Par défaut, connexion uniquement au 127.0.0.1 local. Pas de noms d'outils, pas de modèle de permissions, pas d'undo officiel. Proxifier les requêtes vers l'IDE expose le projet et les capacités de l'IDE à ce client. Les preuves ne disent ni comment consulter le port, ni les précautions pour une exposition non locale.