Spiegazione degli URI delle risorse
Scopra come indirizzare le risorse tramite schema e percorso.
Spiegazione degli URI delle risorse è una lezione MCP Academy gratuita su CoddyKit. Questa è la lezione 1 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.
Che cos'è una risorsa
Una risorsa MCP è un contesto di sola lettura che il server mette a disposizione del modello, ad esempio un file, una configurazione o un record. L'IA lo legge, ma non lo modifica mai.
Perché un indirizzo
Ogni risorsa deve avere un nome stabile affinché un client possa richiederla tramite un riferimento. Questo nome è il suo URI, proprio come una pagina web ha un URL. 🔗
Prima lo schema, poi il percorso
Un URI di risorsa è composto da uno schema, seguito da due punti e barre, e infine da un percorso. Lo schema indica a quale tipo di elemento punta l'URI.
file:///notes/today.txt
config://app/settingsScelga il proprio schema
È libero di inventare uno schema adatto al suo server, come config o db. Lo schema raggruppa le risorse correlate sotto un'unica etichetta chiara.
Lo schema file
Lo schema file è comune per i documenti archiviati su disco. Tre barre indicano che il percorso parte dalla radice, proprio come negli URL file di un browser.
file:///home/data/report.mdEsempio di schema personalizzato
Per i dati dell'app, uno schema personalizzato e ordinato mantiene tutto leggibile. Il modello vede un nome che gli indica esattamente cosa contiene la risorsa.
users://profile/active
weather://city/londonGli URI devono essere univoci
Ogni risorsa deve avere un URI distinto, così le richieste non sono mai ambigue. Due risorse che condividono lo stesso URI entrerebbero in conflitto e confonderebbero i client.
Dichiararlo in FastMCP
Nel Python SDK si associa un URI a una funzione tramite il resource decorator. La stringa indicata è l'indirizzo che i client usano per leggerla.
from mcp.server.fastmcp import FastMCP
mcp = FastMCP("Demo")
@mcp.resource("config://app")
def config(): ...I client elencano gli URI
Quando un client si connette, chiede al server di elencare ogni risorsa che offre. Ogni voce contiene l'URI, un nome e una breve descrizione.
Leggere tramite URI
Per recuperare il contenuto, il client invia una richiesta di lettura indicando l'URI esatto. Il server associa quell'URI a un gestore e restituisce il contenuto.
Mantenga stabili gli URI
Consideri un URI pubblicato come una promessa. Rinominarlo in seguito interrompe qualsiasi client o riferimento salvato che puntava al vecchio indirizzo.
Controllo rapido
Individui la parte che definisce il tipo di risorsa.
Riepilogo
Le risorse sono contesti di sola lettura identificati da un URI: uno schema più un percorso. Mantenga gli URI univoci e stabili, così i client possono farvi affidamento. ✅
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 «Spiegazione degli URI delle risorse» è gratuita?
Sì — il testo completo di «Spiegazione degli URI delle risorse» è 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 «Spiegazione degli URI delle risorse»?
Scopra come indirizzare le risorse tramite schema e percorso. 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 1 di 4.
Quanto tempo richiede la lezione «Spiegazione degli URI delle risorse»?
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