Restituire immagini e dati binari
Invii contenuti non testuali tramite uno strumento.
Restituire immagini e dati binari è una lezione MCP Academy gratuita su CoddyKit. Questa è la lezione 4 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.
Oltre il testo e il JSON
Alcuni strumenti producono immagini o file, non parole. MCP può restituire contenuti binari, come immagini e altri blob, non solo testo.
Il tipo di contenuto immagine
MCP definisce un tipo di contenuto immagine che contiene i byte grezzi e un tipo multimediale. I client che lo supportano possono visualizzare direttamente l'immagine. 🖼️
I byte viaggiano come base64
I dati binari vengono codificati come testo base64 per poter transitare nel messaggio JSON. Il client li decodifica nuovamente in byte reali al momento della ricezione.
L'helper Image
L'SDK Python offre l'helper Image, così non deve codificare nulla manualmente. Gli indichi dei byte o un percorso e lo restituisca.
from mcp.server.fastmcp import Image
return Image(data=png_bytes, format="png")Impostare il tipo multimediale
Indichi sempre il formato, ad esempio png o jpeg, così il client sa come decodificare e visualizzare correttamente l'immagine.
Restituire un file su disco
Legga il file in byte, quindi lo prepari per la restituzione. Lo strumento trasforma un grafico salvato in un risultato visualizzabile dal modello e dall'utente.
data = open("chart.png", "rb").read()
return Image(data=data, format="png")Non solo immagini
Oltre alle immagini, MCP supporta contenuti blob generici per altri dati binari, come PDF o audio, con il relativo tipo multimediale.
Il supporto dei client varia
Non tutti i client possono visualizzare ogni tipo di contenuto. Un host che non è in grado di visualizzare un'immagine può ricorrere a un riferimento o a un link per il download.
Attenzione alle dimensioni
Base64 aumenta i dati di circa un terzo e i blob di grandi dimensioni consumano token e larghezza di banda. Mantenga i contenuti multimediali restituiti ridotti, quando possibile.
Preferire le risorse per i file grandi
Per i file molto grandi o condivisi, esponga una risorsa tramite URI invece di incorporare i byte nel risultato dello strumento. Il client li recupera su richiesta.
Abbinare il testo
Può associare un'immagine a una breve didascalia testuale nello stesso risultato, fornendo al modello sia un'immagine sia parole su cui ragionare.
Verifica rapida
In che modo i dati binari viaggiano all'interno di un messaggio MCP?
Riepilogo: immagini e blob
Può restituire immagini e blob binari tramite base64 con un tipo multimediale, impostare il formato, prestare attenzione alle dimensioni e preferire le risorse per i file grandi. ✅
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 «Restituire immagini e dati binari» è gratuita?
Sì — il testo completo di «Restituire immagini e dati binari» è 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 «Restituire immagini e dati binari»?
Invii contenuti non testuali tramite 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 4 di 4.
Quanto tempo richiede la lezione «Restituire immagini e dati binari»?
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
- Contenuto testuale o strutturato
- Restituire un oggetto risultato tipizzato
- Schemi di output per i client
- Restituire immagini e dati binari