Logging strutturato verso il client

Stampare nel terminale aiuta solo Lei. MCP consente al server di inviare messaggi di log tramite il protocollo, così anche l'app host può mostrarli.

I log viaggiano come una notifica notifications/message. Contiene un livello, un nome opzionale del logger e i dati che desidera registrare.

All'interno di uno strumento, accede al logging tramite l'oggetto Context, lo stesso riferimento usato per l'avanzamento. Non è necessaria alcuna configurazione aggiuntiva.

L'helper più comune è ctx.info. Lo utilizzi per le normali note di stato previste, che aiutano l'utente a seguire ciò che sta facendo lo strumento.

Ricorra a ctx.debug quando desidera tracce dettagliate, come un valore analizzato o un ramo scelto, che risultano troppo rumorose nell'uso quotidiano.

Utilizzi ctx.warning quando qualcosa non è corretto ma può essere recuperato, ad esempio un campo opzionale mancante che ha sostituito con un valore predefinito.

Chiami ctx.error per i problemi reali. Informa il client che un passaggio non è riuscito, separatamente dal sollevamento di un'eccezione che termina la chiamata.

MCP segue la familiare scala syslog: debug, info, notice, warning, error, critical e livelli superiori. I client possono ordinare e colorare i messaggi in base al livello.

Molti helper accettano un nome di logger, così i messaggi possono essere raggruppati per componente, proprio come avviene nel modulo standard di logging di Python.

I messaggi di log escono dal processo e raggiungono il client, quindi li consideri visibili. Non scriva mai in un log segreti come token o password.

Come l'avanzamento, ogni log è una notifica, quindi non blocca mai lo strumento né si aspetta una risposta. Può registrare messaggi liberamente mentre il lavoro procede.

Ora sa emettere log con diversi livelli usando ctx.info, debug, warning ed error, assegnare nomi ai logger e tenere fuori i segreti. Ottimi progressi!