Devolver imágenes y blobs binarios

Algunas herramientas producen imágenes o archivos, no palabras. MCP puede devolver contenido binario, como imágenes y otros blobs, no solo texto.

MCP define un tipo de contenido de imagen que transporta los bytes sin procesar junto con un tipo multimedia. Los clientes compatibles pueden mostrar la imagen directamente. 🖼️

Los datos binarios se codifican como texto base64 para que puedan transportarse en el mensaje JSON. Al llegar, el cliente los vuelve a convertir en bytes reales.

El SDK de Python ofrece un asistente Image para que no tenga que codificar nada manualmente. Solo tiene que indicarle unos bytes o una ruta y devolverlo.

Indique siempre el formato, como png o jpeg, para que el cliente sepa cómo decodificar y mostrar la imagen correctamente.

Lea el archivo como bytes y, después, prepárelo para devolverlo. La herramienta convierte un gráfico guardado en un resultado visible para el modelo y el usuario.

Además de imágenes, MCP admite contenido blob genérico para otros datos binarios, como un PDF o audio, con su propio tipo multimedia.

No todos los clientes pueden mostrar todos los tipos. Un host que no pueda renderizar una imagen puede recurrir a una referencia o a un enlace de descarga.

Base64 aumenta los datos aproximadamente en un tercio, y los blobs grandes consumen tokens y ancho de banda. Mantenga pequeños los archivos multimedia devueltos siempre que pueda.

Para archivos muy grandes o compartidos, exponga un recurso mediante una URI en lugar de insertar los bytes en el resultado de una herramienta. El cliente lo obtiene cuando lo necesita.

Puede combinar una imagen con un breve texto descriptivo en el mismo resultado, proporcionando al modelo tanto una imagen como palabras sobre las que razonar.

Puede devolver imágenes y blobs binarios mediante base64 con un tipo multimedia, establecer el formato, vigilar el tamaño y preferir recursos para archivos grandes. ✅