Tester un serveur MCP avec MCP Inspector

MCP Inspector est l'outil de référence du projet MCP (Model Context Protocol) pour tester et déboguer un serveur. Il se lance sans installation avec npx @modelcontextprotocol/inspector, suivi de la commande qui démarre votre serveur : vous voyez ses outils, ressources et prompts, vous les appelez, et vous lisez les messages échangés. C'est l'étape à faire avant de brancher votre serveur dans Claude Desktop ou Claude Code. Relevé sur la documentation le 15/11/2026.

Prérequis

Node.js en version 22.19.0 ou plus récente. Aucun paquet à installer : npx télécharge et lance Inspector.

Trois interfaces, un seul outil

Le paquet @modelcontextprotocol/inspector contient trois clients qui partagent le même cœur (mêmes transports, mêmes fichiers de configuration, même état OAuth) :

Le mode (--web, --cli ou --tui) se met en tête de commande ; tout ce qui suit est transmis au client ou à votre serveur.

Les commandes utiles

Ouvrir l'interface web sur un serveur local :

npx @modelcontextprotocol/inspector node path/to/server/index.js

La commande affiche une adresse qui contient un jeton propre à ce lancement, et l'ouvre dans le navigateur (variable MCP_AUTO_OPEN_ENABLED=false pour l'en empêcher).

Lister les outils en ligne de commande :

npx @modelcontextprotocol/inspector --cli node path/to/server/index.js --method tools/list

Appeler un outil sur un serveur distant :

npx @modelcontextprotocol/inspector --cli https://api.example.com/mcp --transport http \
  --method tools/call --tool-name get_weather --tool-arg city=Boston --format json

Inspecter un serveur publié :

• paquet npm : npx -y @modelcontextprotocol/inspector npx @modelcontextprotocol/server-filesystem ~/Desktop ;
• paquet PyPI : npx @modelcontextprotocol/inspector uvx mcp-server-git --repository ~/code/mcp/servers.git ;
• serveur HTTP distant : npx @modelcontextprotocol/inspector --server-url https://api.example.com/mcp --transport http.

Lisez toujours le fichier de présentation du serveur d'abord : chaque serveur a ses propres commandes et arguments.

Tester les deux ères du protocole

Depuis la révision 2026-07-28, MCP n'utilise plus la poignée de main initialize. Inspector sait parler les deux : l'ère modern (2026-07-28) et l'ère legacy (la poignée de main de 2025). Par défaut, il utilise legacy. Le tutoriel officiel conseille donc de lancer le même test deux fois :

npx @modelcontextprotocol/inspector --cli node build/index.js --protocol-era modern --method tools/list
npx @modelcontextprotocol/inspector --cli node build/index.js --protocol-era legacy --method tools/list

Si votre serveur liste ses outils dans les deux cas, il répond aux clients récents comme aux plus anciens. Voir ce qui change avec la version 2026-07-28.

Une routine de test simple

1. Démarrage : le serveur se lance-t-il sans écrire sur la sortie standard ? En stdio, tout print() ou console.log() casse les échanges.
2. Découverte : tools/list renvoie-t-il les bons noms, des descriptions claires et des schémas de paramètres complets ?
3. Appels normaux : chaque outil répond-il avec un contenu exploitable ?
4. Appels en erreur : avec un paramètre invalide, l'outil renvoie-t-il un résultat isError: true et un message qui aide à corriger ?
5. Les deux ères : modern et legacy.
6. Automatisation : intégrez les appels --cli --format json à votre chaîne d'intégration continue.

Attention aux secrets

La documentation prévient : Inspector range les jetons OAuth, les secrets de client OAuth et les valeurs env: des serveurs stdio dans le trousseau du système quand il y en a un. Sur une machine sans trousseau (Linux sans libsecret, sessions SSH sans écran, conteneurs), ils sont enregistrés dans ~/.mcp-inspector/secrets.json, non chiffrés sauf si vous fournissez une clé. Sur un serveur partagé ou un poste d'intégration continue, utilisez de préférence des identifiants de test.

Une fois le serveur validé : installez-le dans Claude Desktop ou ajoutez-le à Claude Code.