Chargement

L'inspecteur de serveur

Leçon 534 min
Chargement

Lorsque vous créez des serveurs MCP, vous avez besoin d'un moyen de tester vos fonctionnalités sans vous connecter à une application complète. Le SDK Python MCP inclut un inspecteur intégré basé sur navigateur qui vous permet de déboguer et de tester votre serveur en temps réel.

Démarrer l'Inspector

Tout d'abord, assurez-vous que votre environnement Python est activé (vérifiez le README de votre projet pour connaître la commande exacte). Exécutez ensuite l'inspecteur avec :

bash
mcp dev mcp_server.py

Cela démarre un serveur de développement et vous fournit une URL locale (généralement sur le port 6277) pour accéder à l'inspecteur dans votre navigateur.

Sortie terminal : proxy server listening on port 6277 and MCP Inspector is up and running at http://127.0.0.1:6274.

Utiliser l'interface de l'Inspector

Les images présentées ici et la vidéo montrent la version 1 de l'inspecteur, mais mcp dev démarre désormais la version 2, qui nécessite Node.js 22.19 ou une version ultérieure. Dans la version 2, vous activez le commutateur sur la carte de votre serveur au lieu de cliquer sur « Connect », l'onglet Tools liste vos outils sans bouton « List Tools », et « Run Tool » s'appelle « Execute Tool ».

L'inspecteur MCP avant la connexion, avec transport entrée/sortie standard, un bouton « Connect » et le statut « Disconnected ».

Après avoir cliqué sur « Connect » pour démarrer votre serveur MCP, vous verrez une barre de navigation avec des sections pour :

  • Resources
  • Prompts
  • Tools
  • Autres capacités du serveur

Tester vos outils

La section Tools est celle où vous passerez la majeure partie de votre temps de débogage. Cliquez sur « List Tools » pour voir tous les outils fournis par votre serveur.

Onglet Tools de l'Inspecteur MCP après avoir cliqué sur « List Tools », listant read_doc_contents et edit_document avec une description de chacun.

Lorsque vous sélectionnez un outil, le panneau de droite affiche ses détails et fournit des champs de saisie pour les tests. Par exemple, pour tester l'outil read_doc_contents :

  1. Sélectionnez l'outil dans la liste
  2. Saisissez un identifiant de document (comme « deposition.md »)
  3. Cliquez sur « Run Tool »
  4. Vérifiez les résultats pour vous assurer du succès et du résultat attendu

Onglet Tools de l'Inspecteur MCP listant les outils read_doc_contents et edit_document, avec un champ doc_id et un bouton Run Tool.

Tester les interactions entre outils

Vous pouvez tester plusieurs outils en séquence pour vérifier qu'ils fonctionnent correctement ensemble. Par exemple, après avoir utilisé l'outil edit_document pour modifier du contenu :

Formulaire edit_document de l'Inspecteur MCP avec doc_id deposition.md, old_str "This" et new_str "A report", et Tool Result: Success.

Exécutez à nouveau l'outil read_doc_contents avec le même identifiant de document pour confirmer que vos modifications ont bien été appliquées :

Inspecteur MCP : read_doc_contents sur « deposition.md » affiche Tool Result Success et un texte commençant par "A report deposition covers".

Flux de travail de développement

L'inspecteur crée une boucle de développement efficace :

  • Apportez des modifications au code de votre serveur MCP
  • Testez les outils individuels avec différentes entrées
  • Vérifiez que les interactions entre outils fonctionnent comme prévu
  • Déboguez les problèmes sans avoir besoin d'une configuration d'application complète

Cet environnement de test basé sur navigateur est essentiel pour le développement de serveurs MCP. Il permet de gagner du temps en détectant les problèmes tôt et en vérifiant les fonctionnalités avant l'intégration avec Claude ou d'autres applications.