Pour les développeurs clients

Voici la traduction en français du contenu Markdown, en respectant vos exigences :

Commencez à construire votre propre client capable de s'intégrer à tous les serveurs MCP.

Dans ce tutoriel, vous apprendrez à construire un client chatbot alimenté par un LLM qui se connecte aux serveurs MCP. Il est utile d'avoir suivi le Démarrage rapide du serveur qui vous guide à travers les bases de la construction de votre premier serveur.

Python

Vous pouvez trouver le code complet de ce tutoriel ici.

Configuration requise

Avant de commencer, assurez-vous que votre système répond à ces exigences :

Ordinateur Mac ou Windows

Dernière version de Python installée

Dernière version de uv installée

Configuration de votre environnement

Tout d'abord, créez un nouveau projet Python avec uv :

Configuration de votre clé API

Vous aurez besoin d'une clé API Anthropic depuis la Console Anthropic.

Créez un fichier .env pour la stocker :

Ajoutez votre clé au fichier .env :

Ajoutez .env à votre .gitignore :

Assurez-vous de garder votre ANTHROPIC_API_KEY en sécurité !

Création du client

Structure de base du client

Tout d'abord, configurons nos importations et créons la classe client de base :

Gestion de la connexion au serveur

Ensuite, nous implémenterons la méthode pour se connecter à un serveur MCP :

Logique de traitement des requêtes

Ajoutons maintenant la fonctionnalité principale pour traiter les requêtes et gérer les appels d'outils :

Interface de chat interactive

Nous allons maintenant ajouter la boucle de chat et la fonctionnalité de nettoyage :

Point d'entrée principal

Enfin, nous ajouterons la logique d'exécution principale :

Vous pouvez trouver le fichier client.py complet ici.

Composants clés expliqués

1. Initialisation du client

La classe MCPClient s'initialise avec la gestion de session et les clients API

Utilise AsyncExitStack pour une gestion appropriée des ressources

Configure le client Anthropic pour les interactions Claude

2. Connexion au serveur

Prend en charge les serveurs Python et Node.js

Valide le type de script de serveur

Configure les canaux de communication appropriés

Initialise la session et répertorie les outils disponibles

3. Traitement des requêtes

Maintient le contexte de la conversation

Gère les réponses de Claude et les appels d'outils

Gère le flux de messages entre Claude et les outils

Combine les résultats en une réponse cohérente

4. Interface interactive

Fournit une interface de ligne de commande simple

Gère l'entrée utilisateur et affiche les réponses

Inclut la gestion de base des erreurs

Permet une sortie gracieuse

5. Gestion des ressources

Nettoyage approprié des ressources

Gestion des erreurs pour les problèmes de connexion

Procédures d'arrêt progressif

Points de personnalisation courants

Gestion des outils

Modifiez process_query() pour gérer des types d'outils spécifiques

Ajoutez une gestion personnalisée des erreurs pour les appels d'outils

Implémentez un formatage de réponse spécifique à l'outil

Traitement des réponses

Personnalisez la façon dont les résultats des outils sont formatés

Ajoutez un filtrage ou une transformation des réponses

Implémentez une journalisation personnalisée

Interface utilisateur

Ajoutez une interface graphique ou une interface Web

Implémentez une sortie de console enrichie

Ajoutez un historique des commandes ou une saisie semi-automatique

Exécution du client

Pour exécuter votre client avec n'importe quel serveur MCP :

Si vous continuez le tutoriel sur la météo à partir du démarrage rapide du serveur, votre commande pourrait ressembler à ceci : python client.py .../weather/src/weather/server.py

Le client va :

Se connecter au serveur spécifié

Répertorier les outils disponibles

Démarrer une session de chat interactive où vous pouvez :

Entrer des requêtes

Voir les exécutions d'outils

Obtenir des réponses de Claude

Voici un exemple de ce à quoi cela devrait ressembler si vous êtes connecté au serveur météo à partir du démarrage rapide du serveur :

Comment ça marche

Lorsque vous soumettez une requête :

Le client obtient la liste des outils disponibles auprès du serveur

Votre requête est envoyée à Claude avec les descriptions des outils

Claude décide quels outils (le cas échéant) utiliser

Le client exécute tous les appels d'outils demandés via le serveur

Les résultats sont renvoyés à Claude

Claude fournit une réponse en langage naturel

La réponse vous est affichée

Bonnes pratiques

Gestion des erreurs

Enveloppez toujours les appels d'outils dans des blocs try-catch

Fournissez des messages d'erreur significatifs

Gérez gracieusement les problèmes de connexion

Gestion des ressources

Utilisez AsyncExitStack pour un nettoyage approprié

Fermez les connexions une fois terminé

Gérez les déconnexions du serveur

Sécurité

Stockez les clés API en toute sécurité dans .env

Validez les réponses du serveur

Soyez prudent avec les autorisations des outils

Dépannage

Problèmes de chemin d'accès au serveur

Vérifiez que le chemin d'accès à votre script de serveur est correct

Utilisez le chemin d'accès absolu si le chemin d'accès relatif ne fonctionne pas

Pour les utilisateurs de Windows, assurez-vous d'utiliser des barres obliques (/) ou des barres obliques inverses échappées (\) dans le chemin d'accès

Vérifiez que le fichier serveur a la bonne extension (.py pour Python ou .js pour Node.js)

Exemple d'utilisation correcte du chemin d'accès :

Délai de réponse

La première réponse peut prendre jusqu'à 30 secondes pour revenir

Ceci est normal et se produit pendant que :

Le serveur s'initialise

Claude traite la requête

Les outils sont en cours d'exécution

Les réponses suivantes sont généralement plus rapides

N'interrompez pas le processus pendant cette période d'attente initiale

Messages d'erreur courants

Si vous voyez :

FileNotFoundError : Vérifiez votre chemin d'accès au serveur

Connection refused : Assurez-vous que le serveur est en cours d'exécution et que le chemin d'accès est correct

Tool execution failed : Vérifiez que les variables d'environnement requises de l'outil sont définies

Timeout error : Envisagez d'augmenter le délai d'attente dans votre configuration client

Python#

Configuration requise#

Configuration de votre environnement#

Configuration de votre clé API#

Création du client#

Structure de base du client#

Gestion de la connexion au serveur#

Logique de traitement des requêtes#

Interface de chat interactive#

Point d'entrée principal#

Composants clés expliqués#

1. Initialisation du client#

2. Connexion au serveur#

3. Traitement des requêtes#

4. Interface interactive#

5. Gestion des ressources#

Points de personnalisation courants#

Exécution du client#

Comment ça marche#

Bonnes pratiques#

Dépannage#

Problèmes de chemin d'accès au serveur#

Délai de réponse#

Messages d'erreur courants#