Un outil de calcul, du début à la fin
Créez un petit outil de calcul arithmétique, mais complet.
Un outil de calcul, du début à la fin est une leçon MCP Academy gratuite sur CoddyKit. Ceci est la leçon 4 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.
Certaines parties de cette leçon n'ont pas encore été traduites et s'affichent en anglais.
Build One Complete Tool
Let's combine everything into one small calculator tool, from a clear name to a clean result the model can trust. 🧮
Start with the Server
First create a FastMCP instance to hold the tool. Give it a name so clients can identify your server.
from mcp.server.fastmcp import FastMCP
mcp = FastMCP("calculator")Name the Operation
Pick a precise name. We will add two numbers, so the function add reads clearly to both you and the model.
Declare Typed Parameters
Use type hints so the model sends numbers, not text. We accept two floats to allow decimals as well as whole values.
def add(a: float, b: float) -> float:
...Write the Docstring
The docstring becomes the description, so state plainly what the tool does and what it returns.
def add(a: float, b: float) -> float:
"""Add two numbers and return the sum."""Decorate It as a Tool
Add the tool decorator so FastMCP registers the function and advertises it to any connected client.
@mcp.tool()
def add(a: float, b: float) -> float:
"""Add two numbers."""
return a + bReturn a Clear Result
Returning the sum works, but a labeled result reads better to the model and to the user who sees the answer.
return a + bAdd a Second Tool
One tool per job, so create a separate divide tool rather than packing modes into add. Each stays simple to call.
@mcp.tool()
def divide(a: float, b: float) -> float:
return a / bGuard Against Bad Input
Division by zero would crash, so check first and return a clear error message the model can read and explain.
if b == 0:
return "Error: cannot divide by zero."Run the Server
Finish with the run call so the server starts and listens for a client over stdio when you launch the file.
if __name__ == "__main__":
mcp.run()Test the Whole Tool
Launch it and let a client list your tools. Seeing add and divide with their descriptions confirms the wiring is correct.
Quick Check
Why give divide its own tool instead of a mode flag on add?
Recap
You built a full calculator tool: named clearly, typed parameters, docstring description, guarded errors, and a clean result the model trusts. ✅
Questions Fréquemment Posées
La leçon « Un outil de calcul, du début à la fin » est-elle gratuite ?
Oui — le texte complet de « Un outil de calcul, du début à la fin » 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 « Un outil de calcul, du début à la fin » ?
Créez un petit outil de calcul arithmétique, mais complet. 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 4 sur 4.
Combien de temps prend la leçon « Un outil de calcul, du début à la fin » ?
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
- Bien nommer et décrire un outil
- Déclarer des paramètres avec des annotations de type
- Renvoyer des résultats utiles
- Un outil de calcul, du début à la fin