Defining resources

Concepts Clés : Ressources dans les Serveurs MCP

Objectif de la fonctionnalité :

• Permettre aux utilisateurs de mentionner des documents (ex: @nom_du_document) dans un message.
• Le serveur MCP doit automatiquement récupérer le contenu du document et l'insérer dans le prompt envoyé à l'IA (Claude).

Deux aspects de la fonctionnalité :

• Complétion automatique (Autocomplete) : Afficher une liste de tous les noms de documents disponibles lorsque l'utilisateur tape le symbole @.
• Récupération de contenu : Lorsque l'utilisateur soumet un message contenant une mention, le serveur MCP doit fournir le contenu du document spécifié.

Rôle des Ressources (Resources) :

• Les ressources permettent au serveur MCP d'exposer des données spécifiques au client.
• On définit généralement une ressource pour chaque opération de lecture distincte.

Types de Ressources :

• Ressource Directe (Direct Resource / Statique) : Possède un URI fixe et immuable (ex: docs://documents).
• Ressource Templatée (Templated Resource) : Contient un ou plusieurs paramètres (wildcards) dans son URI, permettant une personnalisation (ex: docs://documents/{doc_id}).
• Le SDK MCP parse automatiquement ces paramètres et les fournit comme arguments de fonction (ex: doc_id).

Flux de Travail (Workflow) :

• Pour la complétion automatique :
• Le client envoie une requête de ressource de lecture au serveur MCP.
• Cette requête inclut un URI spécifique (ex: docs://documents).
• Le serveur exécute la fonction associée et renvoie un résultat.
• Pour la récupération de contenu :
• Le client envoie une requête de ressource de lecture au serveur MCP.
• L'URI contient l'identifiant du document (ex: docs://documents/{doc_id}).
• Le serveur utilise l'ID fourni pour récupérer et renvoyer le contenu du document.

Implémentation Technique (Exemples) :

• Ressource 1 (Liste des IDs) :
• URI : docs://documents (Direct)
• MIME Type : application/json
• Fonction : Retourne une liste des clés (noms) des documents.
• Ressource 2 (Contenu d'un document) :
• URI : docs://documents/{doc_id} (Templaté)
• MIME Type : text/plain
• Fonction : Prend doc_id comme argument, vérifie son existence, et retourne le contenu du document.

Points Clés à Retenir :

• Le serveur MCP est responsable de la récupération des données avant d'envoyer le prompt à l'IA.
• Les ressources permettent de structurer ces opérations de lecture (GET).
• Les types de ressources (Direct vs. Templaté) déterminent si l'URI est fixe ou si elle accepte des variables.

Takeaways

• Le serveur MCP est responsable de la récupération des données (documents) et de leur insertion dans le prompt envoyé à l'IA.
• Les ressources permettent au serveur MCP d'exposer de manière structurée les opérations de lecture (GET) au client.
• Il existe deux types de ressources : Direct (URI fixe et immuable) et Templatée (URI contenant des paramètres ou wildcards).
• Le flux de travail consiste pour le client à envoyer une requête de ressource, que le serveur MCP exécute pour renvoyer le contenu demandé.