L'inspecteur de serveur

Lors du développement de serveurs MCP, vous avez besoin d’un moyen de tester vos fonctionnalités sans connecter une application complète. Le SDK MCP Python inclut un inspecteur basé sur le navigateur qui vous permet de déboguer et de tester votre serveur en temps réel.

Démarrer l’inspecteur

Assurez-vous d’abord que votre environnement Python est activé, puis lancez l’inspecteur :

mcp dev mcp_server.py

Cette commande démarre un serveur de développement et vous donne une URL locale, généralement quelque chose comme http://127.0.0.1:6274. Ouvrez cette URL dans votre navigateur pour accéder à l’inspecteur MCP.

Interface de l’inspecteur

L’interface de l’inspecteur est en développement actif et peut évoluer, mais les fonctionnalités essentielles restent cohérentes. Cherchez ces éléments clés :

• Un bouton Connect pour démarrer votre serveur MCP
• Des onglets de navigation : Resources, Tools, Prompts
• Un panneau de liste et de test des outils

Cliquez d’abord sur le bouton Connect pour initialiser votre serveur. Vous verrez le statut de connexion passer de “Disconnected” à “Connected”.

Tester vos outils

Naviguez vers la section Tools et cliquez sur “List Tools” pour voir tous les outils disponibles de votre serveur. Quand vous sélectionnez un outil, le panneau de droite affiche ses détails et des champs de saisie.

Par exemple, pour tester l’outil de lecture de documents :

1. Sélectionnez l'outil read_doc_contents
2. Entrez un identifiant de document (ex: "deposition.md")
3. Cliquez sur "Run Tool"
4. Vérifiez les résultats pour le succès et la sortie attendue

L’inspecteur affiche à la fois le statut de succès et les données retournées, ce qui facilite la vérification du bon fonctionnement de votre outil.

Tester les interactions entre outils

Vous pouvez tester plusieurs outils en séquence pour vérifier des workflows complexes :

1. Utilisez edit_document pour modifier un document
2. Utilisez immédiatement read_doc_contents pour confirmer que les changements ont été appliqués

L’inspecteur maintient l’état de votre serveur entre les appels d’outils, donc les modifications persistent et vous pouvez vérifier le fonctionnement complet de votre serveur MCP.

Workflow de développement

L’inspecteur MCP devient une partie essentielle de votre processus de développement. Au lieu d’écrire des scripts de test séparés ou de connecter des applications complètes, vous pouvez :

• Itérer rapidement sur les implémentations d’outils
• Tester les cas limites et les conditions d’erreur
• Vérifier les interactions entre outils et la gestion d’état
• Déboguer en temps réel les problèmes

Cette boucle de rétroaction immédiate rend le développement de serveurs MCP beaucoup plus efficace et aide à détecter les problèmes tôt dans le processus de développement.

Astuce : tester les erreurs

N’oubliez pas de tester les cas d’erreur également — entrez un doc_id inexistant et vérifiez que votre serveur retourne une erreur appropriée. Un bon serveur MCP gère les erreurs de manière explicite pour que Claude puisse les interpréter correctement.