Chargement

Requêtes dans le client

Leçon 587 min
Chargement

La dernière étape de la construction de notre client MCP consiste à implémenter la fonctionnalité de requêtes. Cela nous permet de lister toutes les requêtes disponibles depuis le serveur et de récupérer des requêtes spécifiques avec des variables interpolées à l'intérieur.

Implémentation de la liste des requêtes

La méthode list_prompts est simple. Nous appelons la méthode de liste des requêtes de la session et renvoyons les requêtes :

python
async def list_prompts(self) -> list[types.Prompt]:
    result = await self.session().list_prompts()
    return result.prompts

Récupération de requêtes individuelles

La méthode get_prompt est plus intéressante car elle gère l'interpolation des arguments. Lorsque nous demandons une requête spécifique, nous transmettons des arguments qui sont injectés dans la fonction de requête. Par exemple, si notre serveur dispose d'une requête « format » qui attend un paramètre doc_id, nous fournissons cette valeur dans le dictionnaire d'arguments :

python
async def get_prompt(self, prompt_name, args: dict[str, str]):
    result = await self.session().get_prompt(prompt_name, args)
    return result.messages

La méthode renvoie des messages qui forment une conversation prête à être directement transmise à Claude.

Comment fonctionnent les arguments de requête

Lorsque vous définissez une fonction de requête dans votre serveur MCP, tous les paramètres deviennent disponibles en tant que variables d'interpolation. Le dictionnaire d'arguments que vous transmettez à get_prompt fournit les valeurs de ces paramètres. Le serveur génère ensuite la requête complète avec vos valeurs substituées aux emplacements appropriés.

Code de mcp_server.py définissant la requête « format » : son argument doc_id est interpolé entre les balises document_id.

Test de l'implémentation

Une fois implémentées, vous pouvez tester les requêtes via la CLI. Lorsque vous tapez une barre oblique, les requêtes disponibles apparaissent sous forme de commandes. Sélectionner une requête comme « format » vous invitera à choisir des valeurs pour tous les arguments requis (comme sélectionner un document à formater). Le système effectue alors les opérations suivantes :

  1. Récupère la requête avec vos arguments interpolés
  2. Envoie la requête complète à Claude
  3. Claude exécute les appels d'outils nécessaires pour répondre à la demande
  4. Renvoie le résultat formaté

Code du serveur MCP : @mcp.prompt nomme une requête « format » qui réécrit un document en Markdown, avec une fonction format_document.

Les requêtes en pratique

Les requêtes définissent des ensembles réutilisables de messages utilisateur et assistant que les clients peuvent invoquer. Elles doivent être de haute qualité, bien testées et pertinentes par rapport à l'objectif de votre serveur MCP. Considérez-les comme des flux de travail préconstruits qui combinent les outils et les ressources de votre serveur pour accomplir des tâches spécifiques.

Le système de requêtes crée une séparation nette entre la logique de requête (définie sur le serveur) et l'exécution (gérée par le client et Claude). Cela facilite la création de flux de travail sophistiqués et multi-étapes que les utilisateurs peuvent déclencher avec de simples commandes.