Implementare strumenti, risorse e prompt
Crei tutti e tre i primitivi per il caso d'uso.
Implementare strumenti, risorse e prompt è 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.
Costruire tutte e tre le primitive
Con un piano a disposizione, ora scriverà codice reale. Questa lezione collega strumenti, risorse e prompt in un unico server funzionante. 🛠️
Configurare il backend
Per prima cosa, fornisca al server qualcosa su cui operare. Un piccolo archivio, come un elenco o un file SQLite, contiene le note condivise da tutte le primitive.
import sqlite3
db = sqlite3.connect("notes.db")
db.execute("CREATE TABLE IF NOT EXISTS notes(id INTEGER PRIMARY KEY, title TEXT, body TEXT)")Scrivere lo strumento di aggiunta
Il primo strumento crea una nota. Il decoratore lo pubblica e le annotazioni di tipo trasformano gli argomenti in uno schema che il modello può compilare.
@mcp.tool()
def add_note(title: str, body: str) -> str:
db.execute("INSERT INTO notes(title, body) VALUES (?, ?)", (title, body))
db.commit()
return "Saved."Scrivere lo strumento di ricerca
Aggiunga un secondo strumento che cerchi le note per parola chiave. Restituire un breve elenco di corrispondenze mantiene il risultato facile da usare per il modello.
@mcp.tool()
def search_notes(query: str) -> list[str]:
rows = db.execute("SELECT title FROM notes WHERE body LIKE ?", (f"%{query}%",))
return [r[0] for r in rows]Descrivere chiaramente gli strumenti
Fornisca a ogni strumento una docstring semplice. Quel testo diventa la sua descrizione e una descrizione chiara aiuta il modello a scegliere lo strumento giusto al momento giusto.
Esporre una risorsa
Ora fornisca un contesto in sola lettura. Un URI di risorsa consente al modello di recuperare una nota senza modificare nulla nell'archivio.
@mcp.resource("note://{note_id}")
def get_note(note_id: int) -> str:
row = db.execute("SELECT body FROM notes WHERE id = ?", (note_id,)).fetchone()
return row[0] if row else "Not found."Acquisire la variabile URI
Le parentesi graffe nell'URI diventano un argomento della funzione. MCP estrae note_id direttamente dal percorso, così ogni lettura si rivolge esattamente a un record.
Registrare un prompt
Aggiunga un prompt riutilizzabile che l'utente possa attivare. Inquadra una richiesta, così i chiamanti ricevono ogni volta istruzioni coerenti e di alta qualità.
@mcp.prompt()
def summarize(note_id: int) -> str:
return f"Read note://{note_id} and summarize it in three bullet points."Restituire testo utile
Mantenga ogni risultato conciso e leggibile. Stringhe brevi e chiare fanno risparmiare token al modello e rendono l'output rivolto all'utente molto più facile da leggere.
Combinare, mantenendo chiari i ruoli
Gli strumenti agiscono, le risorse leggono e i prompt impartiscono istruzioni. Mantenere distinto ogni ruolo permette ai client e al modello di sapere sempre cosa aspettarsi da ciascuno.
Collegare il punto di ingresso
Concluda il file eseguendo il server, così un client può connettersi. La chiamata run avvia il ciclo e cede il controllo al trasporto.
if __name__ == "__main__":
mcp.run()Controllo rapido
Verifichiamo il dettaglio dell'URI della risorsa.
Riepilogo
Ha implementato tutte e tre le primitive: strumenti che agiscono, una risorsa che legge e un prompt che impartisce istruzioni. Il server del progetto finale ora svolge un lavoro reale. 🎯
Domande Frequenti
La lezione «Implementare strumenti, risorse e prompt» è gratuita?
Sì — il testo completo di «Implementare strumenti, risorse e prompt» è 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 «Implementare strumenti, risorse e prompt»?
Crei tutti e tre i primitivi per il caso d'uso. 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 «Implementare strumenti, risorse e prompt»?
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
- Definire l'ambito del progetto e degli strumenti
- Implementare strumenti, risorse e prompt
- Testare, ispezionare e rafforzare la sicurezza
- Documentare e pubblicare il server