Uno strumento calcolatrice dall'inizio alla fine
Crei uno strumento aritmetico piccolo ma completo.
Uno strumento calcolatrice dall'inizio alla fine è una lezione MCP Academy gratuita su CoddyKit. Questa è la lezione 4 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento MCP Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso MCP Academy include 4 lezioni in totale.
Creare uno strumento completo
Uniamo tutti gli elementi in un piccolo strumento calculator, da un nome chiaro a un risultato ordinato di cui il modello possa fidarsi. 🧮
Iniziare dal server
Per prima cosa crei un'istanza di FastMCP che ospiterà lo strumento. Le assegni un nome, così i client potranno identificare il server.
from mcp.server.fastmcp import FastMCP
mcp = FastMCP("calculator")Dare un nome all'operazione
Scelga un nome preciso. Dobbiamo sommare due numeri, quindi la funzione add è chiara sia per Lei sia per il modello.
Dichiarare parametri tipizzati
Utilizzi i suggerimenti di tipo affinché il modello invii numeri anziché testo. Accettiamo due float per consentire sia valori decimali sia interi.
def add(a: float, b: float) -> float:
...Scrivere la docstring
La docstring diventa la descrizione, quindi indichi chiaramente cosa fa lo strumento e cosa restituisce.
def add(a: float, b: float) -> float:
"""Add two numbers and return the sum."""Decorarlo come strumento
Aggiunga il decorator dello strumento, così FastMCP registrerà la funzione e la renderà disponibile a qualsiasi client connesso.
@mcp.tool()
def add(a: float, b: float) -> float:
"""Add two numbers."""
return a + bRestituire un risultato chiaro
Restituire la somma funziona, ma un risultato con un'etichetta è più chiaro per il modello e per l'utente che vede la risposta.
return a + bAggiungere un secondo strumento
Un solo strumento per ogni compito: crei quindi uno strumento divide separato invece di inserire più modalità in add. Ogni strumento rimane semplice da chiamare.
@mcp.tool()
def divide(a: float, b: float) -> float:
return a / bProteggersi dagli input errati
La divisione per zero causerebbe un arresto anomalo, quindi verifichi prima e restituisca un messaggio di errore chiaro che il modello possa leggere e spiegare.
if b == 0:
return "Error: cannot divide by zero."Avviare il server
Concluda con la chiamata run affinché il server si avvii e resti in ascolto di un client tramite stdio quando avvia il file.
if __name__ == "__main__":
mcp.run()Testare l'intero strumento
Lo avvii e permetta a un client di elencare i suoi strumenti. Vedere add e divide con le relative descrizioni conferma che il collegamento è corretto.
Controllo rapido
Perché assegnare a divide uno strumento separato invece di usare un flag di modalità in add?
Riepilogo
Ha creato uno strumento calcolatrice completo: nome chiaro, parametri tipizzati, descrizione nella docstring, gestione degli errori e un risultato pulito di cui il modello si fida. ✅
Impara Python con un tutor IA — gratis
Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.
- Corsi
- 30
- Lezioni
- 120
Domande Frequenti
La lezione «Uno strumento calcolatrice dall'inizio alla fine» è gratuita?
Sì — il testo completo di «Uno strumento calcolatrice dall'inizio alla fine» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso MCP Academy, passa a CoddyKit PRO. Il corso MCP Academy include 4 lezioni in totale.
Cosa imparerò in «Uno strumento calcolatrice dall'inizio alla fine»?
Crei uno strumento aritmetico piccolo ma completo. Eserciti MCP Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare MCP Academy?
Non è richiesta alcuna esperienza precedente. MCP Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 4 di 4.
Quanto tempo richiede la lezione «Uno strumento calcolatrice dall'inizio alla fine»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione MCP Academy?
Sì. Ogni lezione MCP Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Dare un buon nome e una buona descrizione a uno strumento
- Dichiarare i parametri con le annotazioni di tipo
- Restituire risultati utili
- Uno strumento calcolatrice dall'inizio alla fine