MCP Inspector v2 : un seul paquet, un seul port, et des codes de sortie qui peuvent casser vos scripts

MCP Inspector est l'outil officiel pour examiner un serveur MCP : lister ses outils, les appeler à la main, observer les échanges. Quiconque développe ou fait développer un serveur MCP s'en sert pour vérifier son travail. La version 2 est désormais celle que la commande habituelle installe. La version 1 est dépréciée et ne reçoit plus que des correctifs de sécurité.

Ce qui change

Un seul paquet. La version 1 était répartie en quatre paquets npm. La version 2 n'en publie qu'un, @modelcontextprotocol/inspector. Les anciens paquets annexes sont dépréciés ; un projet qui dépendait de inspector-cli doit passer au paquet principal.

Trois modes, plus un expérimental.

npx @modelcontextprotocol/inspector          # interface web (par défaut)
npx @modelcontextprotocol/inspector --cli    # ligne de commande
npx @modelcontextprotocol/inspector --tui    # interface en terminal (nouveau)

L'option de mode doit venir en premier. Un quatrième outil, mcpdo, est présenté comme expérimental.

Plus de relais. La version 1 lançait une interface sur le port 6274 et un relais sur le port 6277. La version 2 n'a plus qu'un serveur web sur le port 6274. Trois autres ports ne servent que dans des cas précis : 6275 et 6278 pour l'affichage des MCP Apps, 6276 pour le retour d'authentification OAuth.

Un catalogue partagé. La liste des serveurs quitte le stockage du navigateur pour un fichier, par défaut ~/.mcp-inspector/mcp.json, commun aux trois modes. L'option --catalog désigne un fichier que l'outil peut modifier ; --config reste en lecture seule. Les deux ne se cumulent pas.

OAuth en ligne de commande. Absent de la version 1, il arrive avec plusieurs options, dont --stored-auth-only, qui n'ouvre jamais de navigateur et convient à l'intégration continue.

Le piège : les codes de sortie

C'est le changement qui peut casser une chaîne d'intégration continue. En version 1, un appel d'outil qui renvoyait une erreur terminait quand même avec le code 0. En version 2 :

• 0 : succès ;
• 1 : erreur d'usage ou inattendue ;
• 3 : authentification requise ;
• 4 : serveur injoignable ;
• 5 : erreur de l'outil, ou outil introuvable.

Un script qui enchaîne les commandes avec && s'arrêtera donc là où il continuait auparavant. Autre écart : une adresse qui ne se termine ni par /mcp ni par /sse exige désormais de préciser --transport.

Sécurité : des réglages plus stricts

• L'outil refuse d'écouter sur toutes les interfaces réseau (HOST=0.0.0.0), sauf à définir DANGEROUSLY_BIND_ALL_INTERFACES=true.
• Seules les valeurs true ou 1 de DANGEROUSLY_OMIT_AUTH désactivent l'authentification ; en version 1, n'importe quelle valeur suffisait.
• Le jeton s'appelle désormais MCP_INSPECTOR_API_TOKEN. L'ancien nom fonctionne encore, à titre transitoire.
• Jetons OAuth et secrets sont rangés dans le trousseau du système quand il existe. Sinon, ils vont dans ~/.mcp-inspector/secrets.json, non chiffré sauf si une clé est fournie.
• Avec Docker, le guide demande de conserver le préfixe 127.0.0.1: sur les ports publiés, faute de quoi ils sont exposés sur toutes les interfaces de la machine.

Les notes de version récentes des deux lignes mentionnent plusieurs correctifs de sécurité. Raison de plus pour ne pas rester sur une version ancienne.

Prérequis

La version 2 demande Node.js ^22.23.4 || ^24.22.1 || >=26.12.1, c'est-à-dire la version corrigée de chaque ligne maintenue. Pour rester provisoirement sur l'ancienne ligne : npx @modelcontextprotocol/inspector@v1-latest.

Notre lecture

Pour un usage ponctuel, la migration est transparente : la même commande lance la nouvelle interface, et les anciens fichiers de configuration sont acceptés tels quels. Le travail se concentre sur l'automatisation. Si vous testez vos serveurs MCP en intégration continue, relisez les scripts : codes de sortie et ordre des arguments.

Si un prestataire développe votre serveur, demandez-lui avec quelle version de l'Inspector il le teste. Et retenez un réflexe : cet outil manipule des jetons d'accès à vos services. Il se lance sur un poste de développement, jamais sur une machine exposée, et sans les options dont le nom commence par DANGEROUSLY.