Configuración: Hermes Agent con acceso MCP a una sola carpeta
Receta copiable para conectar Hermes Agent al servidor MCP de sistema de archivos limitado a una carpeta y con solo las herramientas que necesitas, explicada línea a línea.
Para qué sirve
MCP es un estándar abierto que su web describe como «un puerto USB-C para aplicaciones de IA»: una forma común de conectar una IA a herramientas y datos. Con esta receta, Hermes Agent puede trabajar con los archivos de una sola carpeta y nada más.
La receta
Abre (o crea) el archivo ~/.hermes/config.yaml y añade:
mcp_servers:
filesystem:
command: "npx"
args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/tu-usuario/proyectos-ia"]
tools:
include: ["read_*", "list_*", "search_*"]Explicación línea a línea
| Línea | Qué hace |
|---|---|
mcp_servers: | Abre la lista de servidores MCP que Hermes debe conectar |
filesystem: | Nombre que tú eliges para este servidor |
command: "npx" | Programa que arranca el servidor (viene con Node.js) |
args: [...] | Descarga el servidor oficial de archivos y le indica la única carpeta permitida |
tools: include: | Deja disponibles solo las herramientas cuyo nombre encaja con estos patrones (aquí, de lectura) |
Cambia /home/tu-usuario/proyectos-ia por la ruta real de tu carpeta. En Windows tendrá una forma como C:/Users/tu-usuario/proyectos-ia.
Cuando quieras que también escriba
Quita el bloque tools: o usa exclude para retirar solo lo que no quieras, por ejemplo:
tools:
exclude: ["move_*"]Haz antes una copia de seguridad de la carpeta.
Cómo comprobarlo
Reinicia Hermes con hermes chat y usa la plantilla de abajo: debería enumerar solo las herramientas permitidas y la carpeta indicada.
Precauciones
- Instala solo servidores MCP de fuentes conocidas: la guía de seguridad de MCP describe el riesgo de servidores locales comprometidos.
- Mantén la lista de herramientas lo más corta posible (minimizar permisos).
Preguntas frecuentes
¿Qué es un servidor MCP?
Un pequeño programa que da a una IA acceso a una herramienta o a unos datos concretos, siguiendo el estándar abierto Model Context Protocol. Aquí, el de sistema de archivos da acceso a una carpeta.
¿Necesito Node.js?
Sí: el ejemplo oficial usa npx, que viene con Node.js, para descargar y arrancar el servidor de sistema de archivos.
¿Puedo dar acceso a varias carpetas?
Sí, añadiendo más rutas a la lista args. Cuantas menos, mejor.
Sigue leyendo
Fuentes
- 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
Historial de cambios
- : Publicación inicial.
Contenido divulgativo, preparado con ayuda de herramientas de IA, con fuentes citadas. No sustituye el consejo de un profesional. Las herramientas cambian rápido: si ves algo desactualizado, escríbenos a contacto@cognenza.com. Cómo trabajamos.