Defining resources

Notes d'étude : Ressources MCP

📚 Concepts Clés des Ressources MCP

• Définition : Les ressources permettent au serveur MCP d'exposer des données ou des opérations spécifiques au client.
• Principe : Une ressource est définie pour chaque opération de lecture distincte.
• Objectif de la fonctionnalité : Permettre aux utilisateurs de mentionner des documents (ex: @nom_document) dans un message.
• Deux aspects de la fonctionnalité :
• Autocomplétion : Afficher une liste des documents disponibles lorsque l'utilisateur tape le symbole @.
• Insertion de Contexte : Récupérer le contenu du document mentionné et l'insérer automatiquement dans le prompt envoyé à l'IA (Claude).

⚙️ Types de Ressources

• Ressources Directes (Statiques) :
• Possèdent un URI fixe et prédéfini (ex: docs://documents).
• Le même URI est utilisé pour toutes les requêtes.
• Ressources Templatées :
• Contiennent un ou plusieurs paramètres (wildcards) dans leur URI (ex: docs://documents/{doc_id}).
• Le SDK MCP Python analyse automatiquement ces paramètres et les fournit comme arguments de mots-clés à la fonction du serveur.
• Elles permettent une sélection ou une personnalisation des données demandées.

🔄 Flux de Requête (Client → Serveur)

• Déclenchement : Le client (application) initie une requête de ressource de lecture (Read Resource Request).
• Identification : Cette requête inclut l'URI de la ressource souhaitée.
• Exécution : Le serveur MCP utilise l'URI pour exécuter la fonction associée.
• Réponse : Le serveur renvoie le résultat dans un message de réponse de ressource de lecture (Read Resource Result).
• Traitement : Le client utilise les données reçues (ex: pour l'autocomplétion ou l'insertion de prompt).

🛠️ Implémentation Pratique

• MIME Type : Utilisé pour donner un indice au client sur le format des données retournées (ex: application/json, text/plain).
• Exemple 1 : Lister les documents (Ressource Directe)
• URI : docs://documents
• MIME Type : application/json
• Fonction : Retourne une liste de chaînes de caractères (les IDs des documents).
• Exemple 2 : Récupérer le contenu d'un document (Ressource Templatée)
• URI : docs://documents/{doc_id}
• MIME Type : text/plain
• Fonction : Prend doc_id comme argument, vérifie son existence, puis retourne le contenu du document sous forme de chaîne de caractères.

Takeaways

• Les ressources MCP permettent au serveur d'exposer des données ou des opérations spécifiques au client, notamment pour l'autocomplétion et l'insertion de contexte de documents.
• Il existe deux types de ressources : les Ressources Directes (URI fixe) et les Ressources Templatées (URI contenant des paramètres ou wildcards).
• Les ressources templated utilisent des paramètres (ex: {doc_id}) que le SDK MCP analyse automatiquement pour les fournir comme arguments à la fonction du serveur.
• Le flux de requête débute par une Read Resource Request du client, qui est exécutée par le serveur pour renvoyer un Read Resource Result.