Servire una risorsa di testo statica
Esponga un documento fisso che il modello possa leggere.
Servire una risorsa di testo statica è 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.
Un documento fisso
La risorsa più semplice è una risorsa statica: una stringa fissa che il server restituisce ogni volta. È ideale per testi della guida, criteri o note di configurazione.
Una funzione, un URI
La espone scrivendo una funzione Python e associandole un URI di risorsa. Quando un client legge quell'URI, la funzione viene eseguita e restituisce il testo.
Il decorator
Il resource decorator registra la funzione sotto il relativo URI. La stringa passata diventa l'indirizzo che i client usano per recuperare il contenuto.
@mcp.resource("info://welcome")
def welcome():
return "Welcome to the server!"Restituire testo semplice
Per una risorsa testuale, è sufficiente restituire una stringa Python. L'SDK la inserisce nella risposta di lettura MCP corretta, così il client riceve contenuto pulito.
Assegnare un nome e descriverla
Assegni alla risorsa una descrizione chiara, così il modello sa quando leggerla. La docstring della funzione viene usata come descrizione.
@mcp.resource("info://welcome")
def welcome():
"Greeting shown to new users."
return "Hello there!"Statica significa senza input
Una risorsa statica non accetta parametri e restituisce sempre lo stesso contenuto. Se deve variare l'output, questo è compito dei template, che vedrà più avanti.
Creare il testo nel codice
Il valore restituito può essere composto in Python prima dell'invio. Per il client il risultato è comunque statico, poiché la stessa chiamata restituisce lo stesso testo.
@mcp.resource("config://limits")
def limits():
return "max_items=100\ntimeout=30"Perché le risorse e non gli strumenti
Usi una risorsa quando il modello deve soltanto leggere un contesto. Gli strumenti servono per le azioni; leggere testo di riferimento è esattamente lo scopo delle risorse.
Il modello la importa
Molti host consentono all'utente di allegare una risorsa a una chat, inserendone il contenuto nel contesto. Il modello ragiona quindi su quel testo insieme al prompt.
Mantenerla leggera
Le risorse statiche si caricano rapidamente, poiché non richiedono elaborazione. Le riservi a testi brevi e stabili, per non sommergere il modello di token.
Testare la risorsa
Avvii il server e usi un client per elencare e leggere l'URI. Se viene restituita esattamente la stringa prevista, il collegamento della risorsa è corretto.
Controllo rapido
Scegliere il primitivo corretto per il testo fisso.
Riepilogo
Una risorsa statica è una funzione associata a un URI che restituisce testo fisso. Aggiunga una descrizione nella docstring e mantenga il contenuto breve. 📄
Domande Frequenti
La lezione «Servire una risorsa di testo statica» è gratuita?
Sì — il testo completo di «Servire una risorsa di testo statica» è 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 «Servire una risorsa di testo statica»?
Esponga un documento fisso che il modello possa leggere. 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 «Servire una risorsa di testo statica»?
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
- Spiegazione degli URI delle risorse
- Servire una risorsa di testo statica
- Leggere un file dal disco
- Impostare il tipo MIME corretto