Les requêtes dans les serveurs MCP vous permettent de définir des instructions préétablies et de haute qualité que les clients peuvent utiliser au lieu de rédiger leurs propres requêtes à partir de zéro. Considérez-les comme des modèles soigneusement conçus qui donnent de meilleurs résultats que ce que les utilisateurs pourraient produire par eux-mêmes.
Pourquoi utiliser des requêtes ?
Supposons que vous souhaitiez que Claude reformate un document en markdown. Un utilisateur pourrait simplement taper « convertir report.pdf en markdown » et obtenir des résultats corrects. Mais il obtiendrait probablement un bien meilleur résultat en utilisant une requête spécialisée, minutieusement testée, que vous auriez conçue spécifiquement pour le formatage de documents.

L'idée clé est que, même si les utilisateurs peuvent accomplir ces tâches par eux-mêmes, ils obtiendront des résultats supérieurs en utilisant des requêtes soigneusement conçues et testées par les auteurs du serveur MCP.
Comment fonctionnent les requêtes
Les requêtes définissent un ensemble de messages utilisateur et assistant que les clients peuvent utiliser directement. Lorsqu'un client demande une requête, votre serveur renvoie une liste de messages pouvant être envoyés directement à Claude.

La structure de base ressemble à ceci :
@mcp.prompt(
name="format",
description="Rewrites the contents of a document in Markdown format",
)
def format_document(
doc_id: str = Field(description="Id of the document to format"),
) -> list[base.Message]:
# Renvoyer une liste de messagesCréation d'une commande de formatage
Voici un exemple pratique. Nous allons créer une commande de formatage qui permet aux utilisateurs de taper /format doc_id pour reformater n'importe quel document en syntaxe markdown.
L'implémentation de la requête inclut des instructions détaillées pour Claude :
def format_document(
doc_id: str = Field(description="Id of the document to format"),
) -> list[base.Message]:
prompt = f"""
Your goal is to reformat a document to be written with markdown syntax.
The id of the document you need to reformat is:
{doc_id}
Add in headers, bullet points, tables, etc as necessary. Feel free to add in structure.
Use the 'edit_document' tool to edit the document. After the document has been reformatted...
"""
return [
base.UserMessage(prompt)
]Tester vos requêtes
Vous pouvez tester des requêtes à l'aide de MCP Inspector. Accédez à l'onglet Prompts, sélectionnez votre requête et fournissez les paramètres requis.

L'inspecteur vous montre exactement quels messages seront envoyés à Claude, y compris la manière dont les paramètres sont interpolés dans le texte de la requête.
Avantages clés
- Contrôle qualité - Vous pouvez tester et affiner les requêtes avant que les utilisateurs ne les voient
- Cohérence - Les utilisateurs obtiennent des résultats fiables à chaque fois
- Spécialisation - Les requêtes peuvent être adaptées au domaine spécifique de votre serveur
- Réutilisabilité - Plusieurs clients peuvent utiliser les mêmes requêtes bien conçues
Détails d'implémentation
N'oubliez pas d'importer le module de base pour les types de messages :
from mcp.server.fastmcp import FastMCP
from mcp.server.fastmcp.prompts import baseLes requêtes doivent être de haute qualité, bien testées et pertinentes par rapport à l'objectif global de votre serveur MCP. Dans notre exemple de gestion de documents, les requêtes de formatage sont tout à fait pertinentes puisque le serveur se spécialise dans les opérations sur les documents.