Defining tools with MCP

Notes d'étude : Création d'un Serveur MCP

Objectif Principal

• Implémenter un serveur MCP (Model Context Protocol) pour étendre les capacités d'un chatbot CLI.
• Le serveur doit fournir des outils (fonctions) que le modèle (Claude) peut utiliser.

Architecture et Outils

• Localisation du code : Le serveur est implémenté dans le fichier MCP server. py.
• Fonctionnalités initiales : Le serveur doit contenir deux outils :
• Lire le contenu d'un document.
• Mettre à jour/modifier le contenu d'un document.
• Stockage des données : Les documents sont stockés en mémoire dans un dictionnaire (docs), où la clé est l'ID du document et la valeur est son contenu.

Utilisation du SDK MCP Python

• Avantage majeur : L'utilisation du SDK MCP Python simplifie grandement la définition des outils.
• Processus simplifié : Au lieu de définir manuellement des schémas JSON complexes, le SDK génère automatiquement le schéma JSON à partir de la définition Python de l'outil.
• Définition d'un outil : Il suffit de spécifier le nom de l'outil, sa description et ses arguments requis.

Implémentation des Outils

**1. Outil : Lire le contenu d'un document (read doc contents)**

• Entrée (Argument) : doc ID (chaîne de caractères).
• Logique : Rechercher l'ID dans le dictionnaire docs et retourner le contenu associé.
• Gestion des erreurs : Si l'ID n'est pas trouvé, lever une ValueError (ex: "doc with ID doc ID not found").

**2. Outil : Modifier un document (edit document)**

• Entrées (Arguments) :
• doc ID (chaîne de caractères) : L'identifiant du document cible.
• old string (chaîne de caractères) : Le texte exact à remplacer.
• new string (chaîne de caractères) : Le nouveau texte à insérer.
• Logique : Effectuer une opération de recherche et remplacement (find and replace) dans le document spécifié.
• Gestion des erreurs : Si l'ID du document n'est pas trouvé, lever une ValueError.

Takeaways

• Le serveur MCP est implémenté pour fournir des outils (fonctions) au chatbot CLI, étendant ainsi ses capacités.
• L'utilisation du SDK MCP Python simplifie la définition des outils en générant automatiquement le schéma JSON à partir de la définition Python.
• Les documents sont stockés en mémoire dans un dictionnaire (docs), utilisant l'ID du document comme clé.
• Deux outils principaux sont implémentés : read doc contents (pour récupérer le contenu) et edit document (pour effectuer une recherche et remplacement).
• Les deux outils doivent gérer les erreurs en levant une ValueError si l'ID du document n'est pas trouvé.