Retornar imagens e dados binários
Envie conteúdo não textual de volta por uma ferramenta.
Retornar imagens e dados binários é uma aula grátis de MCP Academy no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de MCP Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de MCP Academy inclui 4 aulas no total.
Além de texto e JSON
Algumas ferramentas produzem imagens ou arquivos, não palavras. MCP pode retornar conteúdo binário, como imagens e outros dados, não apenas texto.
O tipo de conteúdo de imagem
MCP define um tipo de conteúdo de imagem que transporta os bytes brutos e um tipo de mídia. Os clientes compatíveis podem renderizar a imagem diretamente. 🖼️
Os bytes são transportados como Base64
Os dados binários são codificados como texto base64 para sobreviver à mensagem JSON. Ao chegar, o cliente os decodifica novamente em bytes reais.
O auxiliar de imagem
O SDK do Python oferece um auxiliar Image para que você não precise codificar nada manualmente. Basta fornecer bytes ou um caminho e retorná-lo.
from mcp.server.fastmcp import Image
return Image(data=png_bytes, format="png")Defina o tipo de mídia
Sempre informe o formato, como png ou jpeg, para que o cliente saiba como decodificar e exibir a imagem corretamente.
Retornando um arquivo do disco
Leia o arquivo como bytes e depois prepare-o para retorno. A ferramenta transforma um gráfico salvo em um resultado visualizável para o modelo e para o usuário.
data = open("chart.png", "rb").read()
return Image(data=data, format="png")Não são apenas imagens
Além de imagens, MCP oferece suporte a conteúdo blob genérico para outros dados binários, como um PDF ou áudio, com seu próprio tipo de mídia.
O suporte varia conforme o cliente
Nem todo cliente consegue exibir todos os tipos. Um host que não possa renderizar uma imagem talvez recorra a uma referência ou a um link de download.
Fique atento ao tamanho
Base64 aumenta os dados em cerca de um terço, e blobs grandes consomem tokens e largura de banda. Mantenha a mídia retornada pequena sempre que possível.
Prefira recursos para arquivos grandes
Para arquivos muito grandes ou compartilhados, exponha um resource por URI em vez de inserir os bytes diretamente no resultado da ferramenta. O cliente busca o conteúdo quando necessário.
Combine com texto
Você pode combinar uma imagem com uma breve legenda em texto no mesmo resultado, fornecendo ao modelo uma imagem e palavras sobre as quais raciocinar.
Verificação rápida
Como os dados binários são transportados dentro de uma mensagem MCP?
Recapitulação: imagens e blobs
Você pode retornar imagens e blobs binários por meio de base64 com um tipo de mídia, definir o formato, ficar atento ao tamanho e preferir recursos para arquivos grandes. ✅
Perguntas Frequentes
A aula “Retornar imagens e dados binários” é grátis?
Sim — o texto completo de “Retornar imagens e dados binários” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de MCP Academy, atualize para CoddyKit PRO. O curso de MCP Academy inclui 4 aulas no total.
O que vou aprender em “Retornar imagens e dados binários”?
Envie conteúdo não textual de volta por uma ferramenta. Você pratica MCP Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar MCP Academy?
Nenhuma experiência prévia é necessária. MCP Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.
Quanto tempo leva a aula “Retornar imagens e dados binários”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de MCP Academy?
Sim. Cada aula de MCP Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Conteúdo textual e estruturado
- Retornar um objeto de resultado tipado
- Esquemas de saída para clientes
- Retornar imagens e dados binários