Ajouter un outil de bienvenue
Décorez une fonction Python pour que l’IA puisse l’appeler.
Ajouter un outil de bienvenue est une leçon MCP Academy gratuite sur CoddyKit. Ceci est la leçon 2 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage MCP Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours MCP Academy comprend 4 leçons au total.
Donner une compétence à votre serveur
Un serveur sans outils n'est qu'une coquille vide. Un outil est une fonction Python que l'IA peut appeler pour effectuer réellement une action pour l'utilisateur. 🛠️
Le décorateur magique
FastMCP expose une fonction comme outil en une seule ligne : le décorateur @mcp.tool(), placé juste au-dessus de la définition de votre fonction.
@mcp.tool()
def hello():
...Écrire une fonction classique
Le corps est simplement du Python. Aucun code spécial lié au protocole, aucun JSON à écrire à la main. Vous indiquez ce que l'outil doit faire et vous renvoyez une valeur.
@mcp.tool()
def hello():
return "Hello from MCP!"Ajouter un paramètre
Les outils deviennent plus utiles avec des données en entrée. Ajoutez un paramètre : le modèle pourra alors transmettre une valeur lorsqu'il décidera d'appeler votre outil.
@mcp.tool()
def greet(name):
return "Hello, " + nameLes indications de type construisent le schéma
Ajoutez une indication de type comme name: str et FastMCP la transforme en schéma d'entrée. Le modèle sait alors exactement quel type de valeur envoyer.
@mcp.tool()
def greet(name: str) -> str:
return "Hello, " + nameLa chaîne de documentation devient la description
La chaîne de documentation de votre fonction devient la description de l'outil. Le modèle la lit pour décider quand cet outil est le bon à utiliser.
@mcp.tool()
def greet(name: str) -> str:
"""Greet a person by name."""
return "Hello, " + nameLe nom vient de la fonction
Par défaut, le nom de l'outil est celui de la fonction. Ainsi, def greet publie un outil que le client répertorie sous le nom « greet ».
Renvoyer du texte brut
Pour un premier outil, contentez-vous de renvoyer une chaîne. FastMCP l'enveloppe dans le format de résultat MCP approprié afin que le client reçoive un texte propre.
Bien le décrire
La formulation compte : une description claire aide le modèle à choisir votre outil au bon moment. Des chaînes de documentation vagues entraînent des appels manqués.
L'enregistrement est automatique
Vous n'appelez jamais vous-même une fonction d'enregistrement. Il suffit de le décorer pour que l'outil soit enregistré sur votre instance mcp et prêt à être annoncé.
Ajoutez-en autant que vous voulez
Un serveur peut contenir de nombreux outils. Décorez simplement chaque fonction : ils apparaîtront tous ensemble lorsqu'un client demandera ce qui est disponible.
Vérification rapide
D'où vient la description d'un outil ?
Récapitulatif
Vous avez ajouté un outil avec @mcp.tool(), lui avez donné des paramètres typés et avez utilisé sa chaîne de documentation pour le décrire. Votre serveur peut enfin faire quelque chose. Maintenant, lançons-le ! ✨
Questions Fréquemment Posées
La leçon « Ajouter un outil de bienvenue » est-elle gratuite ?
Oui — le texte complet de « Ajouter un outil de bienvenue » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours MCP Academy, passe à CoddyKit PRO. Le cours MCP Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Ajouter un outil de bienvenue » ?
Décorez une fonction Python pour que l’IA puisse l’appeler. Tu pratiques MCP Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer MCP Academy ?
Aucune expérience préalable n'est requise. MCP Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 2 sur 4.
Combien de temps prend la leçon « Ajouter un outil de bienvenue » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon MCP Academy ?
Oui. Chaque leçon MCP Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Créer une instance FastMCP
- Ajouter un outil de bienvenue
- Exécuter le serveur avec stdio
- Vérifier le chargement et la liste des outils