Chargement

Les requêtes côté client

Leçon 569 min
Chargement

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

Code de serveur MCP définissant une requête nommée « format » qui réécrit le contenu d'un document au format Markdown.

Implémenter List Prompts

La première étape consiste à implémenter la méthode list_prompts dans votre client MCP. Cette méthode récupère toutes les requêtes disponibles depuis le serveur :

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

Cette implémentation simple appelle la méthode list_prompts de la session et renvoie le tableau des requêtes contenu dans le résultat.

Récupérer des requêtes individuelles

La méthode get_prompt récupère une requête spécifique avec des arguments interpolés. Lorsque vous demandez une requête, vous fournissez des arguments qui sont transmis à la fonction de requête sous forme d'arguments nommés :

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 les messages contenus dans le résultat, qui forment une conversation pouvant être transmise directement à Claude.

Fonctionnement des arguments de requête

Lorsque vous définissez une fonction de requête côté serveur, elle peut accepter des paramètres. Par exemple, une requête de mise en forme de document pourrait attendre un paramètre doc_id :

python
def format_document(doc_id: str):
    # Le doc_id est interpolé dans la requête

Lorsque le client appelle get_prompt, le dictionnaire d'arguments doit contenir les clés attendues. Le serveur MCP transmettra ces valeurs sous forme d'arguments nommés à la fonction de requête, permettant d'insérer dynamiquement du contenu dans le modèle de requête.

Tester les requêtes dans la CLI

Une fois l'implémentation réalisée, vous pouvez tester les requêtes via l'interface en ligne de commande. Lorsque vous tapez une barre oblique, les requêtes disponibles apparaissent sous forme de commandes. La sélection d'une requête peut vous inviter à choisir parmi les options disponibles (comme des identifiants de documents), puis la requête complète est envoyée à Claude.

Terminal exécutant uv run main.py avec « /format plan.md » saisi et une liste d'autocomplétion de fichiers avec plan.md surligné.

Le flux de travail se déroule ainsi :

  1. L'utilisateur sélectionne une requête (comme « format »)
  2. Le système demande les arguments requis (comme le document à mettre en forme)
  3. La requête est envoyée à Claude avec les valeurs interpolées
  4. Claude peut alors utiliser des outils pour récupérer des données supplémentaires et accomplir la tâche

Markdown de terminal avec une ligne de tableau de ressources indiquant « Development Team 5 FTE Phases 1-5 » et une section Risk Management.

Bonnes pratiques en matière de requêtes

Lorsque vous créez des requêtes pour votre serveur MCP :

  • Rendez-les pertinentes par rapport à l'objectif de votre serveur
  • Testez-les soigneusement avant le déploiement
  • Utilisez des instructions claires et précises
  • Concevez-les pour qu'elles fonctionnent bien avec vos outils disponibles
  • Réfléchissez aux arguments que les utilisateurs devront fournir

Les requêtes comblent l'écart entre les fonctionnalités prédéfinies et les besoins dynamiques des utilisateurs, en offrant à Claude des points de départ structurés pour des tâches complexes tout en conservant une flexibilité grâce à la paramétrisation.