URI parametrizzati delle risorse
Acquisisca le variabili direttamente dal percorso dell'URI.
URI parametrizzati 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.
Un modello, molte risorse
Una risorsa statica ha un unico indirizzo fisso. Un URI parametrizzato è un modello che rappresenta un'intera famiglia di risorse contemporaneamente. ✨
Segnaposto tra parentesi graffe
Indichi la parte variabile di un URI con un segnaposto tra parentesi graffe, ad esempio users://{user_id}/profile. La parentesi graffa rappresenta uno spazio da riempire.
users://{user_id}/profileIl modello è una promessa
Un modello di risorsa comunica al client che qualsiasi URI corrispondente a questa struttura è valido. Il modello può inserire valori reali per richiedere esattamente ciò di cui ha bisogno.
Registrare con un decoratore
Nel Python SDK si registra un modello nello stesso modo di uno strumento: con il decoratore @mcp.resource, passando il modello URI come argomento.
@mcp.resource("users://{user_id}/profile")
def get_profile(user_id: str) -> str:
return f"Profile for {user_id}"I nomi devono corrispondere
Ogni segnaposto nell'URI deve comparire come parametro della funzione con lo stesso nome. L'SDK collega direttamente {user_id} all'argomento user_id.
Catturare più valori
Può catturare diverse variabili in un unico URI. Ogni segnaposto corrisponde al proprio parametro, quindi un solo modello può individuare dati molto specifici.
@mcp.resource("repos://{owner}/{name}/readme")
def readme(owner: str, name: str) -> str:
return load_readme(owner, name)I valori arrivano come stringhe
Le parti catturate dall'URI arrivano come testo. Se Le serve un numero, lo converta autonomamente all'interno della funzione prima di utilizzarlo.
def get_page(page: str) -> str:
n = int(page)
return render_page(n)Un segmento per segnaposto
Per impostazione predefinita, un segnaposto cattura un singolo segmento del percorso, ovvero il testo tra due barre. Si ferma alla barra successiva, quindi non ingloba il resto del percorso.
I modelli non si elencano da soli
Una risorsa semplice compare nell'elenco delle risorse. Una risorsa parametrizzata di solito non vi compare, poiché gli URI possibili sono infiniti. Il client la legge compilando il modello.
Mantenere gli URI significativi
Progetti URI che siano leggibili come indirizzi chiari, ad esempio weather://{city}/today. Un modello sceglie la risorsa corretta con molta più affidabilità quando il percorso è autoesplicativo.
weather://{city}/todayPerché è importante
Gli URI parametrizzati consentono a una sola funzione ordinata di servire migliaia di risorse. Scrive la struttura una sola volta e le parti variabili fanno il resto. 🎯
Verifica rapida
In che modo un segnaposto URI catturato raggiunge la funzione?
Riepilogo
Ha imparato che gli URI parametrizzati usano segnaposto tra parentesi graffe per servire un'intera famiglia di risorse, ciascuno associato al parametro della funzione corrispondente. Prossimo argomento: creare il relativo contenuto. 🚀
Domande Frequenti
La lezione «URI parametrizzati delle risorse» è gratuita?
Sì — il testo completo di «URI parametrizzati 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 «URI parametrizzati delle risorse»?
Acquisisca le variabili direttamente dal percorso dell'URI. 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 «URI parametrizzati 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
- URI parametrizzati delle risorse
- Creare il contenuto al momento della lettura
- Risorse elencate o basate su template
- Notificare ai client gli aggiornamenti