Defining tools with MCP

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

Objectif Principal

• Mettre en place un serveur MCP (Model Context Protocol) pour un chatbot CLI.
• Le serveur doit intégrer des outils (fonctions) permettant à l'IA d'interagir avec des documents.

Technologie Clé : MCP Python SDK

• Le SDK simplifie la création du serveur (une seule ligne de code).
• Il simplifie la définition des outils : il n'est pas nécessaire d'écrire manuellement les schémas JSON.
• Processus : On définit la fonction Python → Le SDK génère le schéma JSON pour l'IA.

Outils Implémentés

• Outil : Lire le contenu d'un document (read_doc_contents)
• Entrée : doc_id (chaîne de caractères).
• Logique :
• Vérifier si doc_id existe dans le dictionnaire docs.
• Si non trouvé : Lever une ValueError (ex: "doc with ID not found").
• Si trouvé : Retourner le contenu du document (docs[doc_id]).

• Outil : Modifier un document (edit_document)
• Entrées : doc_id (chaîne), old_string (chaîne), new_string (chaîne).
• Logique :
• Vérifier si doc_id existe dans docs.
• Si trouvé : Effectuer une opération de remplacement (find-and-replace) :

docs[doc_id] = docs[doc_id]. replace(old_string, new_string)

Concepts Clés de la Définition d'Outil

• Utilisation du décorateur @MCP. tool pour identifier la fonction comme un outil.
• Définition des arguments (nom, type, description) directement dans la signature de la fonction.
• Le SDK gère la conversion des types Python en schémas JSON pour le modèle (Claude).

Takeaways

• Le serveur MCP est mis en place pour permettre à un chatbot CLI d'interagir avec des documents via des outils intégrés.
• Le SDK MCP simplifie grandement la création du serveur et la définition des outils, générant automatiquement les schémas JSON pour l'IA.
• Les outils sont identifiés et définis en Python en utilisant le décorateur @MCP. tool et en spécifiant les arguments dans la signature de la fonction.
• Les outils implémentés permettent de lire le contenu d'un document (avec gestion des erreurs si l'ID n'existe pas) ou d'effectuer un remplacement de texte.