Definir o tipo MIME correto
Informe aos clientes se o conteúdo é texto, JSON ou outro formato.
Definir o tipo MIME correto é 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.
O que é um tipo MIME
Um tipo MIME é um rótulo curto que informa ao cliente que tipo de conteúdo um recurso contém, como texto simples, JSON ou uma imagem.
Por que isso importa
O rótulo permite que o cliente renderize e interprete o conteúdo corretamente. Sem ele, um cliente pode exibir JSON bruto como texto ou lidar incorretamente com um bloco binário. 🏷️
O padrão de texto
Se nada for informado, o MCP pressupõe text/plain. Isso serve para notas e documentos, mas dados estruturados merecem um tipo mais preciso.
Tipos comuns
O senhor usará alguns com frequência: text/plain para prosa, application/json para dados e text/markdown para documentos formatados que o modelo possa interpretar.
Declará-lo no FastMCP
Defina o tipo com o argumento tipo MIME no decorador de recurso, para que os clientes saibam exatamente como ler o corpo.
@mcp.resource("data://stats", mime_type="application/json")
def stats():
return '{"users": 42}'JSON da maneira correta
Para JSON, identifique-o como application/json e retorne uma cadeia de caracteres JSON válida. Construa-a com a biblioteca json para que as aspas e os caracteres de escape estejam sempre corretos.
import json
@mcp.resource("data://stats", mime_type="application/json")
def stats():
return json.dumps({"users": 42})Markdown para documentos
Fornecendo um README ou guia? Use text/markdown para que clientes compatíveis renderizem títulos e listas, em vez de exibirem símbolos brutos.
@mcp.resource("docs://readme", mime_type="text/markdown")
def readme():
return "# Welcome\nGetting started..."Associe o tipo ao conteúdo
O tipo deve descrever honestamente o corpo. Identificar texto simples como JSON faz os clientes tentarem interpretá-lo e falharem; portanto, mantenha-os sempre sincronizados.
Binários exigem cuidado
Para imagens ou PDFs, defina um tipo MIME binário, como image/png, e os bytes viajarão codificados em base64 para sobreviverem a um protocolo de texto.
Detectar pela extensão
Ao fornecer arquivos, o Python pode deduzir um tipo a partir do nome do arquivo. A biblioteca mimetypes associa uma extensão ao tipo MIME padrão correspondente.
import mimetypes
mt, _ = mimetypes.guess_type("report.json")
# mt == "application/json"Um pequeno contrato
Pense no tipo MIME como um pequeno contrato: ele promete ao cliente qual é o formato dos bytes, para que os dois lados concordem antes da interpretação.
Verificação rápida
Escolha o tipo correto para dados estruturados.
Recapitulação
O tipo MIME informa aos clientes como ler um recurso. Use tipo MIME para definir texto, JSON, markdown ou conteúdo binário, e seja coerente com o conteúdo. 🏷️
Aprenda Python com um tutor de IA — grátis
Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.
- Cursos
- 30
- Aulas
- 120
Perguntas Frequentes
A aula “Definir o tipo MIME correto” é grátis?
Sim — o texto completo de “Definir o tipo MIME correto” é 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 “Definir o tipo MIME correto”?
Informe aos clientes se o conteúdo é texto, JSON ou outro formato. 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 “Definir o tipo MIME correto”?
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
- URIs de recursos explicadas
- Disponibilizar um recurso de texto estático
- Ler um arquivo do disco
- Definir o tipo MIME correto