Chargement
Chargement

Les ressources dans MCP permettent à votre serveur d'exposer des données qui peuvent être directement incluses dans les requêtes, plutôt que de nécessiter des appels d'outils pour accéder à l'information. Cela crée un moyen plus efficace de fournir du contexte aux modèles d'IA comme Claude.

Pour remplir l'autocomplétion, le client MCP lit docs://documents depuis le serveur MCP et renvoie les noms de documents à notre code.

Comprendre le flux de ressources

Lorsqu'un utilisateur tape quelque chose comme « What's in the @... » dans votre application, le système doit récupérer une liste des ressources disponibles pour l'autocomplétion. Le client MCP envoie une ReadResourceRequest au serveur, qui répond avec une liste de noms de documents pouvant être référencés.

Mettre en œuvre la lecture de ressources

La fonctionnalité principale se déroule dans la méthode read_resource de votre client MCP. Cette méthode prend un paramètre URI qui identifie la ressource à récupérer depuis le serveur.

Tout d'abord, ajoutez les imports nécessaires pour gérer l'analyse JSON et la validation des URL :

python
import json
from pydantic import AnyUrl

L'implémentation principale effectue une requête au serveur MCP et traite la réponse :

python
async def read_resource(self, uri: str) -> Any:
    result = await self.session().read_resource(AnyUrl(uri))
    resource = result.contents[0]

Gérer différents types de contenu

Les ressources peuvent renvoyer différents types de contenu, vous devez donc vérifier le type MIME pour traiter la réponse de manière appropriée :

python
if isinstance(resource, types.TextResourceContents):
    if resource.mimeType == "application/json":
        return json.loads(resource.text)
    
return resource.text

Cette approche garantit que les ressources JSON sont correctement analysées, tandis que les ressources en texte brut sont renvoyées telles quelles.

Tester l'implémentation

Une fois l'implémentation effectuée, vous pouvez tester la fonctionnalité de ressources en exécutant votre application CLI. Lorsque vous tapez « @ » suivi d'un nom de ressource, le système va :

  • Afficher les ressources disponibles dans une liste d'autocomplétion
  • Vous permettre de sélectionner une ressource à l'aide des flèches et de la barre d'espace
  • Inclure le contenu de la ressource directement dans la requête envoyée à Claude

Cela signifie que Claude reçoit le contenu du document immédiatement sans avoir besoin d'effectuer des appels d'outils supplémentaires, ce qui rend l'interaction beaucoup plus efficace.

Avantages clés

Les ressources offrent plusieurs avantages par rapport aux outils pour accéder à des informations statiques :

  • Le contenu est inclus directement dans les requêtes, réduisant la latence
  • Aucun appel API supplémentaire n'est nécessaire pendant la conversation
  • Meilleure expérience utilisateur grâce à la fonctionnalité d'autocomplétion
  • Séparation plus nette entre les données statiques et les opérations dynamiques

Les ressources fonctionnent le mieux pour des informations relativement statiques que vous souhaitez rendre facilement accessibles aux modèles d'IA, telles que la documentation, les rapports ou les documents de référence.