Chargement

Définir des ressources

Leçon 555 min
Chargement

Les ressources dans les serveurs MCP vous permettent d'exposer des données aux clients, de manière similaire aux gestionnaires de requêtes GET dans un serveur HTTP classique. Elles sont parfaites pour les scénarios où vous devez récupérer des informations plutôt qu'effectuer des actions.

Comprendre les ressources

Considérez les ressources comme des points de terminaison en lecture seule qui peuvent renvoyer tout type de données - chaînes de caractères, JSON, fichiers binaires, etc. Vous définissez un 'mime_type' pour donner au client une indication sur le type de données que vous renvoyez.

Diagramme d'un serveur MCP contenant deux ressources, la ressource directe list_docs et la ressource modélisée fetch_doc, illustrées dans le code ci-dessous.

Les ressources fonctionnent en définissant un URI (comme une URL) que les clients peuvent demander. Lorsqu'un client a besoin de données, il envoie une ReadResourceRequest avec l'URI spécifique, et votre serveur répond avec un ReadResourceResult contenant les données.

Deux types de ressources

Il existe deux principaux types de ressources que vous pouvez créer :

  • Ressources directes - Ont des URI statiques qui ne contiennent aucun paramètre (comme "docs://documents")
  • Ressources modélisées - Incluent des paramètres dans leurs URI qui sont analysés et transmis à votre fonction (comme "docs://documents/{doc_id}")

Ressource directe, sans paramètres d'URI, à côté de la ressource modélisée, dont les paramètres d'URI sont transmis par le SDK Python à votre fonction.

Pour les ressources modélisées, le SDK Python analyse automatiquement les paramètres à partir de l'URI et les transmet sous forme d'arguments nommés à votre fonction. Les noms des paramètres dans l'URI doivent correspondre exactement aux noms des paramètres de votre fonction.

Créer des ressources

Voici comment implémenter les deux types de ressources :

python
@mcp.resource(
    "docs://documents",
    mime_type="application/json"
)
def list_docs() -> list[str]:
    return list(docs.keys())

@mcp.resource(
    "docs://documents/{doc_id}",
    mime_type="text/plain"
)
def fetch_doc(doc_id: str) -> str:
    if doc_id not in docs:
        raise ValueError(f"Doc with id {doc_id} not found")
    return docs[doc_id]

Le SDK Python MCP sérialise automatiquement tout ce que vous renvoyez. Vous n'avez pas besoin de convertir manuellement les données en chaînes JSON - il vous suffit de renvoyer des objets Python et le SDK se charge de la conversion.

Tester vos ressources

Vous pouvez tester les ressources à l'aide du MCP Inspector. Démarrez votre serveur avec :

uv run mcp dev mcp_server.py

Connectez-vous ensuite à l'inspecteur dans votre navigateur. Vous verrez deux sections :

  • Resources - Répertorie vos ressources directes/statiques
  • Resource Templates - Affiche vos ressources modélisées

Onglet Resources du MCP Inspector : la ressource docs://documents, le modèle fetch_doc, et une réponse JSON listant six documents.

Cliquez sur n'importe quelle ressource pour la tester. Pour les ressources modélisées, vous devrez fournir des valeurs pour les paramètres. L'inspecteur vous montre la structure exacte de la réponse que votre client recevra, y compris le type mime et les données sérialisées.

Cas d'usage pratiques

Les ressources sont idéales pour implémenter des fonctionnalités telles que les mentions de documents dans les applications de chat. Par exemple, lorsqu'un utilisateur tape "@" pour mentionner un document, vous pourriez :

  1. Utiliser une ressource directe pour récupérer une liste de tous les documents disponibles pour l'autocomplétion
  2. Utiliser une ressource modélisée pour récupérer le contenu d'un document spécifique lorsqu'il est mentionné

Cette approche vous permet d'injecter de manière préventive le contenu des documents dans les requêtes sans obliger l'IA à utiliser des outils pour récupérer les informations.