Ler um arquivo do disco
Transforme um arquivo local em um recurso MCP dinâmico.
Ler um arquivo do disco é uma aula grátis de MCP Academy no CoddyKit. Esta é a aula 3 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.
Do fixo ao dinâmico
Retornar uma cadeia de caracteres codificada diretamente é aceitável, mas os servidores reais disponibilizam arquivos de verdade. O senhor pode ler um arquivo do disco e fornecer seu conteúdo dinamicamente.
Ler dentro do manipulador
Sua função de recurso simplesmente abre o arquivo e retorna seu texto. Como ela é executada a cada solicitação, o cliente sempre recebe o conteúdo atual. 📂
Um recurso de arquivo básico
Abra o arquivo, leia-o e retorne a cadeia de caracteres. O recurso agora reflete o que estiver salvo no disco no momento da leitura.
@mcp.resource("file:///notes.txt")
def notes():
with open("notes.txt") as f:
return f.read()Usar Pathlib de forma organizada
A biblioteca pathlib lê arquivos pequenos em uma única linha e lida com caminhos com segurança em diferentes sistemas, mantendo o manipulador curto e claro.
from pathlib import Path
@mcp.resource("file:///notes.txt")
def notes():
return Path("notes.txt").read_text()Tratar arquivos ausentes
Um arquivo pode desaparecer ou ser renomeado. Envolva a leitura em um tratamento para que um arquivo ausente retorne uma mensagem de erro clara, em vez de interromper o servidor.
try:
return Path(p).read_text()
except FileNotFoundError:
raise ValueError("File not found")Atenção à codificação
Os arquivos de texto têm uma codificação. Leia explicitamente com utf-8 para que caracteres acentuados e de outros idiomas cheguem intactos ao modelo.
Path("notes.txt").read_text(encoding="utf-8")Observe o tamanho do arquivo
Retornar um arquivo enorme inunda o modelo com tokens e pode atingir os limites. Mantenha pequenos os arquivos fornecidos ou leia apenas a parte de que o modelo realmente precisa.
Nunca confie no caminho
Se um caminho vier de uma entrada, um invasor poderá solicitar arquivos fora da sua pasta. Sempre restrinja as leituras a um diretório-base seguro sob seu controle.
Resolver dentro de uma base
Calcule um caminho absoluto e verifique se ele permanece dentro da raiz permitida. Isso bloqueia truques de travessia de caminho, como subir usando ponto-ponto.
base = Path("data").resolve()
target = (base / name).resolve()
if base not in target.parents: raise ValueError("Denied")Somente para leitura por natureza
Os recursos apenas leem; nunca escrevem. Fornecer um arquivo como recurso expõe seu conteúdo sem permitir que o modelo o modifique.
Verificar a leitura dinâmica
Altere o arquivo no disco e depois leia o URI novamente. Ver o novo texto prova que o servidor faz uma leitura dinâmica, em vez de usar conteúdo antigo armazenado em cache.
Verificação rápida
Verificação de segurança ao fornecer arquivos.
Recapitulação
Leia um arquivo dentro do manipulador para manter o conteúdo dinâmico. Defina utf-8, trate arquivos ausentes, observe o tamanho e restrinja os caminhos a uma raiz segura. ✅
Perguntas Frequentes
A aula “Ler um arquivo do disco” é grátis?
Sim — o texto completo de “Ler um arquivo do disco” é 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 “Ler um arquivo do disco”?
Transforme um arquivo local em um recurso MCP dinâmico. 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 3 de 4.
Quanto tempo leva a aula “Ler um arquivo do disco”?
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