Defining resources

🇫🇷 Notes de Cours : Les Ressources dans les Serveurs MCP

📚 Concepts Clés des Ressources MCP

• Définition : Les ressources permettent à un serveur MCP (Model Context Provider) d'exposer des données spécifiques au client.
• Objectif Principal : Permettre au client d'accéder à des données (comme des documents) via des requêtes structurées, plutôt que de laisser le modèle (ex: Claude) effectuer la recherche.
• Principe de Base : Une ressource est généralement définie pour chaque opération de lecture distincte.

⚙️ Types de Ressources

• Ressource Directe (Statique) :
• Possède un URI fixe et prédéfini (ex: docs://documents).
• Utilisée pour des opérations génériques (ex: obtenir la liste de tous les documents).
• Ressource Templatée :
• Contient un ou plusieurs paramètres (wildcards) dans son URI (ex: docs://documents/{doc_id}).
• Le SDK MCP parse automatiquement ces paramètres et les fournit à la fonction associée sous forme d'arguments de mot-clé.
• Utilisée pour des requêtes spécifiques (ex: obtenir le contenu d'un document donné).

🔄 Flux de Travail (Workflow)

• Requête du Client : Le client envoie une requête de ressource de lecture au serveur MCP, incluant l'URI souhaitée.
• Exécution du Serveur : Le serveur MCP identifie l'URI, exécute la fonction associée et récupère les données.
• Réponse du Serveur : Le serveur renvoie un message de résultat de ressource de lecture au client.
• Traitement du Client : Le client utilise les données reçues (ex: pour remplir une fenêtre d'autocomplétion ou insérer le contexte dans le prompt).

🛠️ Implémentation Technique

• Décorateur : L'implémentation utilise le décorateur mcp. resource.
• Définition : Chaque ressource nécessite la définition d'un URI et d'un type MIME (ex: application/json, text/plain).
• Type MIME : Indique au client le format des données retournées.
• Gestion des Données : Le SDK MCP gère la sérialisation (conversion en chaîne de caractères) des données retournées par la fonction.
• Vérification : Pour les ressources templétées, il est crucial de vérifier l'existence des paramètres (ex: s'assurer que doc_id existe dans la base de données avant de le retourner).

Takeaways

• Les ressources MCP permettent au client d'accéder à des données spécifiques via des requêtes structurées, contournant la recherche effectuée par le modèle.
• Il existe deux types de ressources : Directes (URI fixe pour opérations génériques) et Templatées (URI avec paramètres pour requêtes spécifiques).
• L'implémentation technique repose sur le décorateur mcp. resource et exige la définition d'un URI et d'un type MIME pour chaque ressource.
• Le flux de travail est : Requête du client (URI) → Exécution de la fonction par le serveur MCP → Réponse des données au client pour traitement.