MCP Inspector : tester et déboguer un serveur MCP (guide v2, 2026)

Publié le · Développement & SDK · 3 min de lecture

Par Amir N., éditeur de serveurmcp.com · Mis à jour le 8 octobre 2026

MCP Inspector est l’outil officiel du projet Model Context Protocol pour tester et déboguer un serveur MCP. Il se connecte à votre serveur, liste ses outils, ressources et prompts, et vous permet de les appeler un par un.

Sa version 2, actuellement en 2.10.1, propose quatre interfaces : web, ligne de commande, terminal et mcpdo. Ce guide couvre le lancement, les commandes utiles et la sécurité.

MCP Inspector en bref

  • Éditeur : le projet officiel Model Context Protocol, en open source.
  • Installation : aucune, il se lance avec npx. Il demande Node.js 22.19 ou plus récent.
  • Interfaces : web par défaut, ligne de commande, terminal, et mcpdo en expérimental.
  • Serveurs testés : locaux en stdio, ou distants en Streamable HTTP et SSE.

Lancer MCP Inspector

npx @modelcontextprotocol/inspector                   # interface web (par défaut)
npx @modelcontextprotocol/inspector --cli             # ligne de commande
npx @modelcontextprotocol/inspector --tui             # interface dans le terminal
npx -p @modelcontextprotocol/inspector mcpdo --help   # mcpdo (expérimental)

Pour tester un serveur local, ajoutez sa commande de lancement à la suite, par exemple npx @modelcontextprotocol/inspector node build/index.js. Les trois interfaces principales partagent les mêmes options de connexion.

Les quatre interfaces

Interface Option Pour quoi faire
Web aucune Explorer un serveur visuellement : outils, ressources, prompts et applications MCP
Ligne de commande --cli Scripts, tests automatisés et intégration continue
Terminal --tui Travailler sans navigateur, directement dans le terminal
mcpdo binaire dédié Se connecter une fois, puis enchaîner les commandes sur cette connexion

Tester un serveur en ligne de commande

Le mode --cli se connecte, exécute une méthode MCP, puis se déconnecte. Il est idéal pour vérifier un serveur après chaque modification.

Objectif Option
Vérifier la connexion --method initialize
Lister les outils --method tools/list
Appeler un outil --method tools/call --tool-name nom --tool-arg cle=valeur
Lister les ressources --method resources/list
Lister les prompts --method prompts/list

Exemple complet sur un serveur local :

npx @modelcontextprotocol/inspector --cli node build/index.js --method tools/call --tool-name mytool --tool-arg key=value

Pour un serveur distant, passez son URL et le transport, avec un en-tête d’authentification si besoin :

npx @modelcontextprotocol/inspector --cli https://mon-serveur.example.com --transport http --method tools/list --header "X-API-Key: votre-cle"

Un fichier de configuration évite de tout retaper : --config chemin/config.json --server monserveur.

Ce que l’Inspector vérifie pour vous

  • Portabilité des schémas : l’interface web signale les schémas d’arguments que certains clients MCP liraient mal, en erreurs et en avertissements. Le même contrôle alimente le rapport --strict de la ligne de commande.
  • Sorties structurées : les résultats d’outils affichent à part leur contenu structuré.
  • Applications MCP : un écran dédié lance les interfaces que votre serveur propose.

Sécurité

  • Les secrets, comme les jetons OAuth et les variables d’environnement des serveurs locaux, sont rangés dans le trousseau du système. Sans trousseau, ils vont dans un fichier secrets.json, non chiffré sauf si vous fournissez une clé.
  • L’interface web est protégée par un jeton intégré à la page. Elle refuse d’écouter sur toutes les interfaces réseau, sauf réglage explicite DANGEROUSLY_BIND_ALL_INTERFACES.
  • N’exposez jamais l’Inspector sur un réseau public, et testez avec des comptes de test plutôt qu’avec vos accès de production.

Passer de la v1 à la v2

La v2 exige Node.js 22.19 ou plus récent. Elle renomme plusieurs options et variables d’environnement, et sépare les fichiers --config et --catalog. Le guide de migration officiel donne la correspondance complète.

Vous développez votre propre serveur ? Notre tutoriel Créer son premier serveur MCP en Python : tutoriel pas à pas se teste pas à pas avec l’Inspector.

Questions fréquentes

MCP Inspector est-il gratuit ?

Oui. C’est un outil open source du projet officiel MCP, qui se lance avec npx.

Quelle version de Node.js faut-il ?

Node.js 22.19 ou plus récent.

Comment tester un serveur MCP distant ?

Avec npx @modelcontextprotocol/inspector --cli, suivi de l’URL du serveur, de --transport http et de la méthode à appeler.

Peut-on utiliser l’Inspector sans navigateur ?

Oui, avec --cli pour les scripts et l’intégration continue, ou --tui pour une interface dans le terminal.

Où l’Inspector stocke-t-il les jetons ?

Dans le trousseau du système par défaut, sinon dans un fichier secrets.json.

Sources

Pour découvrir le protocole, lisez notre guide Qu’est-ce que le MCP ?

Recevez gratuitement le guide complet du MCP

Une newsletter simple, sans spam. Désinscription en un clic.