Accedere all'oggetto contesto
Acceda al contesto della richiesta all'interno di uno strumento.
Accedere all'oggetto contesto è una lezione MCP Academy gratuita su CoddyKit. Questa è la lezione 3 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.
Conosca l'oggetto Context
L'oggetto Context è il punto di accesso dello strumento alla richiesta: contiene lo stato condiviso e funzioni di supporto per la registrazione dei log e l'avanzamento.
Lo richieda tramite il tipo
Aggiunga un parametro con annotazione di tipo Context e FastMCP lo inserirà automaticamente. I client non vedranno mai questo argomento.
from mcp.server.fastmcp import Context
@mcp.tool()
async def greet(name: str, ctx: Context) -> str:
return "hi " + nameAcceda allo stato condiviso
Acceda a ctx.request_context.lifespan_context per ottenere esattamente l'oggetto restituito dal lifespan all'avvio.
app = ctx.request_context.lifespan_context
rows = await app.db.query("...")Usi la connessione attiva
Ora le chiamate allo strumento operano sul pool condiviso, invece di aprire una connessione completamente nuova a ogni chiamata.
Registri i log tramite il contesto
Chiami ctx.info per inviare una riga di log al client: è molto più utile di una print nascosta sul server.
await ctx.info("loading user " + str(user_id))Comunichi anche l'avanzamento
Per le operazioni lente, ctx.report_progress trasmette aggiornamenti sulla percentuale completata, così l'host può mostrare all'utente una barra di avanzamento.
await ctx.report_progress(progress=3, total=10)Viene inserito automaticamente, non passato
Il modello non valorizza mai ctx. FastMCP riconosce l'annotazione di tipo e lo fornisce automaticamente, mantenendolo fuori dallo schema dello strumento.
Gli strumenti asincroni amano il contesto
La maggior parte delle funzioni di supporto del contesto è awaitable, quindi definisca come asincrone le funzioni degli strumenti che usano il contesto, per poterle chiamare in modo pulito.
Lo chiami come preferisce
Il nome del parametro dipende da lei; ciò che conta è l'annotazione di tipo. Per convenzione, spesso viene semplicemente chiamato ctx.
Un contesto per richiesta
Ogni chiamata a uno strumento riceve il proprio contesto della richiesta, ma tutti i contesti rimandano allo stesso stato persistente del lifespan.
Legga i metadati della richiesta
Il contesto espone anche i metadati della richiesta, così uno strumento può esaminare i dettagli della chiamata specifica che sta gestendo.
Verifica rapida
Come si ottiene l'oggetto Context all'interno di uno strumento FastMCP?
Riepilogo: l'oggetto Context
Accede allo stato condiviso tramite ctx.request_context.lifespan_context e usa ctx per la registrazione dei log e l'avanzamento. Prossimo argomento: arrestare il server correttamente. 🔌
Domande Frequenti
La lezione «Accedere all'oggetto contesto» è gratuita?
Sì — il testo completo di «Accedere all'oggetto contesto» è 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 «Accedere all'oggetto contesto»?
Acceda al contesto della richiesta all'interno di uno strumento. 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 3 di 4.
Quanto tempo richiede la lezione «Accedere all'oggetto contesto»?
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
- L'hook di avvio del ciclo di vita
- Condividere lo stato tramite il contesto dell'app
- Accedere all'oggetto contesto
- Arresto ordinato e rilascio delle risorse