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 :
async def list_prompts(self) -> list[types.Prompt]:
result = await self.session().list_prompts()
return result.promptsRé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 :
async def get_prompt(self, prompt_name, args: dict[str, str]):
result = await self.session().get_prompt(prompt_name, args)
return result.messagesLa 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.

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 :
- Récupère la requête avec vos arguments interpolés
- Envoie la requête complète à Claude
- Claude exécute les appels d'outils nécessaires pour répondre à la demande
- Renvoie le résultat formaté

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.