Defining resources

📚 Notes de Cours : Les Ressources MCP

Objectif Principal :

• Implémenter la fonctionnalité de mention de documents (ex: @nom_fichier) pour insérer automatiquement le contenu du document dans le prompt envoyé à Claude.

Concepts Clés des Ressources MCP :

• Définition : Les ressources permettent au serveur MCP d'exposer des données spécifiques au client.
• Types de Ressources :
• Directes (Statiques) : Possèdent une URI fixe (ex: docs://documents).
• Modèles (Templated) : Contiennent un ou plusieurs paramètres (wildcards) dans l'URI (ex: docs://documents/{doc_id}).
• Fonction : Les paramètres de l'URI sont automatiquement passés comme arguments de fonction au serveur.

Flux de Fonctionnement (Mention de Document) :

• Autocomplete (Liste des documents) :
• Le client envoie une requête de lecture (read resource request) au serveur.
• Le serveur répond avec une liste des noms/IDs de documents disponibles (souvent via une ressource directe).
• Récupération du Contenu :
• Le client utilise l'ID du document dans l'URI de la ressource (via une ressource modèle).
• Le serveur exécute la fonction associée et renvoie le contenu du document.

Implémentation Technique :

• Décorateur : Les ressources sont définies en utilisant MCP. resource(URI, mime_type).
• MIME Type : Indique le format des données retournées au client (ex: application/json ou text/plain).
• Gestion des Données :
• Le serveur renvoie les données (souvent sérialisées en chaîne de caractères).
• Le client est responsable de la désérialisation de ces données pour les utiliser.

Exemples de Ressources (Structure) :

• Liste des IDs :
• URI : docs://documents
• MIME Type : application/json
• Retour : Liste des clés du dictionnaire de documents.
• Contenu d'un document :
• URI : docs://documents/{doc_id}
• MIME Type : text/plain
• Argument : doc_id (string)
• Retour : Contenu du document.

Takeaways

• Les ressources MCP permettent au serveur d'exposer des données spécifiques au client via des URI.
• Il existe deux types de ressources : Directes (URI fixe) et Modèles (avec des paramètres/wildcards qui sont passés comme arguments de fonction).
• Le flux de mention de document se déroule en deux étapes : une requête de lecture pour obtenir la liste des IDs, puis l'utilisation d'une ressource modèle pour récupérer le contenu.
• Les ressources sont implémentées en utilisant le décorateur MCP. resource(URI, mime_type).