Aggiungere uno strumento Hello
Decori una funzione Python affinché l'intelligenza artificiale possa chiamarla.
Aggiungere uno strumento Hello è una lezione MCP Academy gratuita su CoddyKit. Questa è la lezione 2 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.
Dare una competenza al server
Un server senza strumenti è solo un guscio. Uno strumento è una funzione Python che l'IA può chiamare per fare concretamente qualcosa per l'utente. 🛠️
Il decoratore magico
FastMCP espone una funzione come strumento con una sola riga: il decoratore @mcp.tool() inserito subito sopra la definizione della funzione.
@mcp.tool()
def hello():
...Scrivere una funzione normale
Il corpo è semplicemente Python. Non servono codice speciale per il protocollo né JSON scritto manualmente. Lei definisce cosa deve fare lo strumento e restituisce un valore.
@mcp.tool()
def hello():
return "Hello from MCP!"Aggiungere un parametro
Gli strumenti diventano più utili quando ricevono dati in ingresso. Aggiunga un parametro e il modello potrà passare un valore quando decide di chiamare lo strumento.
@mcp.tool()
def greet(name):
return "Hello, " + nameI suggerimenti di tipo creano lo schema
Aggiunga un suggerimento di tipo come name: str e FastMCP lo trasformerà in uno schema di input. Il modello saprà così esattamente quale tipo di valore inviare.
@mcp.tool()
def greet(name: str) -> str:
return "Hello, " + nameLa docstring diventa la descrizione
La docstring della funzione diventa la descrizione dello strumento. Il modello la legge per decidere quando è opportuno usare quello strumento.
@mcp.tool()
def greet(name: str) -> str:
"""Greet a person by name."""
return "Hello, " + nameIl nome deriva dalla funzione
Per impostazione predefinita, il nome dello strumento è il nome della funzione. Quindi def greet pubblica uno strumento che il client elenca come "greet".
Restituire testo semplice
Per il primo strumento, è sufficiente restituire una stringa. FastMCP la inserisce nella struttura di risultato MCP corretta, così il client riceve testo pulito.
Descriverlo bene
Usare parole appropriate è importante: una descrizione chiara aiuta il modello a scegliere lo strumento al momento giusto. Docstring vaghe causano chiamate mancate.
La registrazione è automatica
Non deve chiamare personalmente alcuna funzione di registrazione. Grazie al decoratore, lo strumento viene registrato automaticamente nell'istanza mcp ed è pronto per essere pubblicizzato.
Ne può aggiungere quanti desidera
Un server può contenere molti strumenti. Applichi semplicemente il decoratore a ogni funzione: compariranno tutti insieme quando un client chiederà quali strumenti sono disponibili.
Verifica rapida
Da dove deriva la descrizione di uno strumento?
Riepilogo
Ha aggiunto uno strumento con @mcp.tool(), gli ha assegnato parametri tipizzati e ha lasciato che la docstring lo descrivesse. Il server ora può finalmente fare qualcosa. Adesso eseguiamolo! ✨
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 «Aggiungere uno strumento Hello» è gratuita?
Sì — il testo completo di «Aggiungere uno strumento Hello» è 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 «Aggiungere uno strumento Hello»?
Decori una funzione Python affinché l'intelligenza artificiale possa chiamarla. 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 2 di 4.
Quanto tempo richiede la lezione «Aggiungere uno strumento Hello»?
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
- Creare un'istanza FastMCP
- Aggiungere uno strumento Hello
- Eseguire il server con stdio
- Verificare il caricamento e l'elenco degli strumenti