Déboguer les serveurs LLM sans prise de tête avec MCP Inspector

Vous connaissez ce sentiment : vous essayez de faire fonctionner un agent IA avec votre API locale, et soit il se fige, soit il crache une erreur cryptique. Vous vous demandez : le prompt est-il cassé, le serveur a-t-il planté, ou les données arrivent-elles dans un mauvais format ? Scénario familier. Les développeurs d'Anthropic semblent avoir vécu la même chose, c'est pourquoi ils ont publié MCP Inspector.

Il s'agit d'un débogueur visuel pour le Model Context Protocol (MCP). En résumé, MCP est un nouveau standard qui aide les modèles de langage à communiquer avec des outils externes, des bases de données et des systèmes de fichiers. Et Inspector est basically un Postman, mais adapté spécifiquement pour travailler avec les serveurs LLM.

Ce qu'il y a sous le capot et comment ça fonctionne

L'outil se compose de deux parties. La première est un client React que vous voyez dans le navigateur. La seconde est un serveur proxy fonctionnant sur Node.js. Ce proxy est la partie la plus intéressante : il peut convertir des flux d'entrée/sortie standard (stdio) ou des flux HTTP en une interface adaptée au navigateur.

De nombreux serveurs MCP fonctionnent via des entrées/sorties console standard. Un navigateur ne peut pas communiquer directement avec un tel processus, donc le proxy fait office de pont : il lance votre serveur, intercepte ses messages et les diffuse vers l'interface web.

Comment démarrer rapidement

Si vous avez Node.js version 22.7.5 ou supérieure, tapez simplement dans votre terminal :

npx @modelcontextprotocol/inspector

La commande lancera une interface web sur http://localhost:6274. D'ailleurs, le choix des ports est amusant : 6274 correspond aux touches MCPI (MCP Inspector) sur un ancien téléphone à clavier.

Si vous construisez actuellement votre propre serveur, vous pouvez pointer l'inspector directement dessus :

npx @modelcontextprotocol/inspector node build/index.js

L'inspector récupérera le build, passera les arguments nécessaires et ouvrira le navigateur avec tous vos outils et ressources visibles.

Ce que ce débogueur peut faire

Le principal attrait de l'inspector est son interactivité. Vous n'avez pas besoin d'écrire des scripts pour tester chaque fonction.

Premièrement, il y a le test d'outils. Vous voyez une liste de toutes les fonctions que le serveur expose au modèle. Vous pouvez remplir les arguments directement dans le formulaire (pas de JSON manuel dans la console) et cliquer sur "Call Tool". La réponse revient instantanément, et vous pouvez immédiatement voir si la structure de données a "bougé" ou a été corrompue.

Deuxièmement, il y a la navigation dans les ressources. Si votre serveur fournit un accès à des fichiers ou des logs, vous pouvez les explorer dans une interface arborescente dans l'inspector. C'est un sauveur quand vous avez besoin de comprendre exactement quel contexte le modèle reçoit.

Troisièmement, il y a la gestion des prompts. Vous pouvez tester les modèles de prompts intégrés au serveur et voir comment ils se peuplent avec des données en temps réel.

Sécurité et nuances

Les développeurs n'ont pas ajouté cet avertissement massif au README pour rien. L'essentiel est que le serveur proxy a le droit de lancer des processus sur votre machine. Si vous ouvrez simplement son port sur internet, n'importe qui peut exécuter du code arbitraire.

Par défaut, l'inspector génère un token de session aléatoire. Il ressemble à ceci : http://localhost:6274/?MCP_PROXY_AUTH_TOKEN=ваш_длинный_хеш

Je ne recommanderais pas de désactiver cette vérification avec le flag DANGEROUSLY_OMIT_AUTH, même si vous êtes trop paresseux pour copier le lien. Il y a eu des cas (CVE-2025-49596) où de tels ports ouverts pourraient entraîner un RCE simplement en visitant un site malveillant dans un autre onglet du navigateur.

Quand l'utiliser

Pour moi, la plus grande découverte était le mode CLI. Il est parfait pour être associé avec Cursor ou d'autres assistants de codage IA. Vous pouvez exécuter une commande :

npx @modelcontextprotocol/inspector --cli node build/index.js --method tools/list

Et obtenir du JSON propre avec une liste d'outils. Cela accélère le cycle "j'ai écrit du code — testé — corrigé" par bonds et par sauts.

L'inspector sera définitivement utile si vous :

1. Construisez un serveur MCP personnalisé pour votre entreprise.
2. Essayiez de connecter Claude Desktop avec une base de données locale.
3. Déboguiez des chaînes d'appels d'outils complexes où l'ordre des arguments compte.

L'outil s'est avéré étonnamment solide pour un protocole si jeune. Oui, la documentation est encore un peu clairsemée, et l'interface paraît basique, mais il excelle dans son travail — "vous montrer ce qu'il y a sous le capot d'un serveur LLM".

Si vous prévoyez d'intégrer des agents IA dans vos workflows, marquez ce repo. Cela vous fera gagner beaucoup d'heures de débogage de champs manqués dans les schémas JSON ou de chemins de fichiers incorrects.