Configuração: Hermes Agent com acesso MCP a uma só pasta
Receita para copiar que liga o Hermes Agent ao servidor MCP de sistema de ficheiros, limitado a uma pasta e só com as ferramentas de que precisas, explicada linha a linha.
Para que serve
O MCP é um padrão aberto que o seu site descreve como «uma porta USB-C para aplicações de IA»: uma forma comum de ligar uma IA a ferramentas e dados. Com esta receita, o Hermes Agent pode trabalhar com os ficheiros de uma só pasta e mais nada.
A receita
Abre (ou cria) o ficheiro ~/.hermes/config.yaml e acrescenta:
mcp_servers:
filesystem:
command: "npx"
args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/o-teu-utilizador/projetos-ia"]
tools:
include: ["read_*", "list_*", "search_*"]Explicação linha a linha
| Linha | O que faz |
|---|---|
mcp_servers: | Abre a lista de servidores MCP que o Hermes deve ligar |
filesystem: | Nome que escolhes para este servidor |
command: "npx" | Programa que arranca o servidor (vem com o Node.js) |
args: [...] | Descarrega o servidor oficial de ficheiros e indica-lhe a única pasta permitida |
tools: include: | Deixa disponíveis apenas as ferramentas cujo nome corresponde a estes padrões (aqui, de leitura) |
Substitui /home/o-teu-utilizador/projetos-ia pelo caminho real da tua pasta. No Windows terá uma forma como C:/Users/o-teu-utilizador/projetos-ia.
Quando quiseres que também escreva
Retira o bloco tools: ou usa exclude para retirar só o que não quiseres, por exemplo:
tools:
exclude: ["move_*"]Faz antes uma cópia de segurança da pasta.
Como verificar
Reinicia o Hermes com hermes chat e usa o modelo abaixo: deverá enumerar apenas as ferramentas permitidas e a pasta indicada.
Precauções
- Instala apenas servidores MCP de fontes conhecidas: o guia de segurança do MCP descreve o risco de servidores locais comprometidos.
- Mantém a lista de ferramentas o mais curta possível (minimizar permissões).
Perguntas frequentes
O que é um servidor MCP?
Um pequeno programa que dá a uma IA acesso a uma ferramenta ou a dados concretos, seguindo o padrão aberto Model Context Protocol. Aqui, o de sistema de ficheiros dá acesso a uma pasta.
Preciso do Node.js?
Sim: o exemplo oficial usa o npx, que vem com o Node.js, para descarregar e arrancar o servidor de sistema de ficheiros.
Posso dar acesso a várias pastas?
Sim, acrescentando mais caminhos à lista args. Quanto menos, melhor.
Continue a ler
Fontes
- MCP en Hermes Agent (documentación oficial) — Nous Research (GitHub)
- What is the Model Context Protocol? — Model Context Protocol
- Security Best Practices (MCP) — Model Context Protocol
Histórico de alterações
- : Publicação inicial.
Conteúdo divulgativo, preparado com a ajuda de ferramentas de IA, com fontes citadas. Não substitui o aconselhamento de um profissional. As ferramentas mudam depressa: se vir algo desatualizado, escreva-nos para contacto@cognenza.com. Como trabalhamos.