Chargement
Chargement

La dernière étape de la construction de notre client MCP consiste à implémenter la fonctionnalité des 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émenter 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

Obtenir des 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, cette valeur est transmise et interpolée dans le texte réel de la requête.

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.

Tester les requêtes en action

Lorsque vous exécutez le client et tapez une barre oblique, vous verrez les requêtes disponibles sous forme de commandes. En sélectionnant une requête comme « format », vous serez invité à choisir parmi les documents disponibles. Le système alors :

  • Prend la requête avec l'identifiant du document interpolé
  • La transmet directement à Claude en tant que message utilisateur
  • Claude reçoit à la fois les instructions et l'identifiant du document
  • Claude utilise les outils disponibles pour récupérer le contenu du document
  • Claude répond avec le résultat reformaté

Taper une barre oblique dans le client liste « /format », qui réécrit le contenu du document au format Markdown.

Comment fonctionnent les requêtes

Les requêtes définissent un ensemble de messages utilisateur et assistant qui peuvent être utilisés par le client. Ces requêtes doivent être de haute qualité, bien testées et pertinentes par rapport à l'objectif global de votre serveur MCP.

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

Le flux de travail est le suivant :

  1. Écrivez et évaluez une requête pertinente par rapport à l'objectif de votre serveur MCP
  2. Définissez la requête à l'intérieur de votre serveur MCP à l'aide du décorateur @mcp.prompt
  3. Votre client peut demander cette requête à tout moment
  4. Lors de la demande de la requête, fournissez des arguments qui sont transmis en tant qu'arguments nommés à la fonction de requête
  5. La fonction utilise ces arguments pour personnaliser le contenu de la requête

Ce système crée des requêtes réutilisables et paramétrables qui peuvent être partagées entre différents clients et cas d'usage, rendant votre serveur MCP plus polyvalent et plus puissant.