MCP Academy · Lección

Establecer el tipo MIME correcto

Indique a los clientes si el contenido es texto, JSON u otro formato.

Lección 4 de 413 pasos

Establecer el tipo MIME correcto es una lección gratuita de MCP Academy en CoddyKit. Esta es la lección 4 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de MCP Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de MCP Academy incluye 4 lecciones en total.

Qué es un tipo MIME

Un tipo MIME es una etiqueta breve que indica a un cliente qué tipo de contenido contiene un recurso, como texto sin formato, JSON o una imagen.

Por qué es importante

La etiqueta permite que el cliente represente y analice el contenido correctamente. Sin ella, un cliente podría mostrar JSON sin formato como texto o gestionar mal un bloque binario. 🏷️

El valor predeterminado para texto

Si no indica nada, MCP asume text/plain. Es adecuado para notas y documentos, pero los datos estructurados necesitan un tipo más preciso.

Tipos habituales

Usará algunos con frecuencia: text/plain para prosa, application/json para datos y text/markdown para documentos con formato que el modelo pueda analizar.

Declararlo en FastMCP

Establezca el tipo con el argumento mime_type del decorador del recurso para que los clientes sepan exactamente cómo leer el cuerpo.

@mcp.resource("data://stats", mime_type="application/json")
def stats():
    return '{"users": 42}'

JSON de la forma correcta

Para JSON, etiquételo como application/json y devuelva una cadena JSON válida. Constrúyala con la biblioteca json para que las comillas y los caracteres de escape sean siempre correctos.

import json

@mcp.resource("data://stats", mime_type="application/json")
def stats():
    return json.dumps({"users": 42})

Markdown para documentos

¿Va a servir un README o una guía? Use text/markdown para que los clientes compatibles representen los encabezados y las listas en lugar de mostrar símbolos sin formato.

@mcp.resource("docs://readme", mime_type="text/markdown")
def readme():
    return "# Welcome\nGetting started..."

Hacer coincidir el tipo con el contenido

El tipo debe describir fielmente el cuerpo. Etiquetar texto sin formato como JSON hace que los clientes intenten analizarlo y fallen, así que manténgalos siempre sincronizados.

Los datos binarios requieren cuidado

Para imágenes o PDF, establezca un tipo MIME binario como image/png, y los bytes viajarán codificados en base64 para sobrevivir a un protocolo de texto.

Detectarlo a partir de la extensión

Al servir archivos, Python puede deducir un tipo a partir del nombre del archivo. La biblioteca mimetypes asigna una extensión a su tipo MIME estándar.

import mimetypes
mt, _ = mimetypes.guess_type("report.json")
# mt == "application/json"

Un pequeño contrato

Considere el tipo MIME como un pequeño contrato: promete al cliente qué forma tienen los bytes para que ambas partes estén de acuerdo antes de analizarlos.

Comprobación rápida

Elija el tipo correcto para datos estructurados.

Resumen

El tipo MIME indica a los clientes cómo leer un recurso. Use mime_type para establecer texto, JSON, markdown o datos binarios, y asegúrese de que sea coherente. 🏷️

Gratis para empezar

Aprende Python con un tutor de IA — gratis

Escribe y ejecuta código real en tu navegador, obtén ayuda instantánea de un tutor de IA disponible 24/7 y continúa donde lo dejaste en la web o en la aplicación.

Cursos
30
Lecciones
120

Preguntas frecuentes

¿La lección «Establecer el tipo MIME correcto» es gratis?

Sí — el texto completo de «Establecer el tipo MIME correcto» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de MCP Academy, actualiza a CoddyKit PRO. El curso de MCP Academy incluye 4 lecciones en total.

¿Qué aprenderé en «Establecer el tipo MIME correcto»?

Indique a los clientes si el contenido es texto, JSON u otro formato. Practicas MCP Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar MCP Academy?

No se requiere experiencia previa. MCP Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 4 de 4.

¿Cuánto tiempo toma la lección «Establecer el tipo MIME correcto»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de MCP Academy?

Sí. Cada lección de MCP Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

  1. Explicación de los URI de recursos
  2. Servir un recurso de texto estático
  3. Leer un archivo del disco
  4. Establecer el tipo MIME correcto
← Volver a MCP Academy