Defining tools with MCP

Notes d'étude : Création de Serveurs MCP et Définition d'Outils

• Objectif Principal : Ajouter un serveur MCP (Multi-Context Platform) à un chatbot CLI pour lui donner des fonctionnalités supplémentaires (outils).
• Localisation du Code : L'implémentation du serveur est placée dans le fichier mcpserver. py.
• Rôle du SDK Python MCP :
• Le SDK simplifie grandement la création du serveur MCP (souvent en une seule ligne de code).
• Il automatise la définition des outils. Au lieu d'écrire manuellement des schémas JSON complexes, l'utilisateur définit l'outil en Python, et le SDK génère le schéma JSON nécessaire pour l'IA (Claude).
• Structure des Documents : Les documents sont initialement stockés en mémoire dans un dictionnaire (docs), où la clé est l'ID du document et la valeur est son contenu.
• Définition d'un Outil (Processus) :
• Définir l'outil via la syntaxe du SDK (@mcp. tool).
• Attribuer un nom et une description clairs à l'outil.
• Définir la fonction Python réelle qui sera exécutée lorsque l'outil est appelé.
• Outil 1 : Lecture de Document (read_doc_contents)
• Entrée : doc_id (chaîne de caractères).
• Logique : Récupérer le contenu du document correspondant dans le dictionnaire docs.
• Gestion des Erreurs : Vérifier si doc_id existe dans docs. Si non, lever une ValueError (Document non trouvé).
• Outil 2 : Édition de Document (edit_document)
• Entrées : doc_id (ID du document), old_string (texte à remplacer), new_string (nouveau texte).
• Logique : Effectuer une opération de recherche et remplacement (find and replace) dans le contenu du document spécifié.
• Gestion des Erreurs : Vérifier si doc_id existe dans docs. Si non, lever une ValueError.
• Conclusion : L'utilisation du SDK MCP réduit considérablement la complexité de la définition des outils, permettant de se concentrer sur la logique métier (la fonction Python).

Takeaways

• Le serveur MCP (Multi-Context Platform) est utilisé pour ajouter des fonctionnalités (outils) à un chatbot CLI.
• Le SDK Python MCP simplifie la création des outils en automatisant la génération du schéma JSON à partir de la définition en Python.
• Les documents sont initialement stockés en mémoire dans un dictionnaire, où la clé est l'ID du document.
• La définition d'un outil implique d'utiliser la syntaxe @mcp. tool, d'attribuer un nom/description, et de fournir la fonction Python d'exécution.
• Les outils implémentés (ex: read_doc_contents, edit_document) doivent gérer les erreurs, notamment la vérification de l'existence de l'ID du document.