Hermes — Servidor MCP del Cerebro Digital

Conector MCP remoto que expone el Cerebro Digital (vault de Obsidian alojado en Nextcloud) a Claude. Lee las notas en vivo por WebDAV, las indexa en memoria y ofrece herramientas de búsqueda y lectura para que el equipo consulte el conocimiento de la empresa desde su Claude — sin costo de API, usando los asientos existentes.

Herramientas que expone

• buscar(consulta) — encuentra notas relevantes por texto.
• leer_nota(ruta) — devuelve el contenido completo de una nota.
• listar(subcarpeta) — explora la estructura de carpetas del vault.
• estado() — muestra cuántas notas hay indexadas y la última actualización.

Variables de entorno

Variable	Descripción
NEXTCLOUD_URL	URL de Nextcloud (ej. https://drive.mystoredigital.cloud)
NEXTCLOUD_USER	Usuario de Nextcloud
NEXTCLOUD_APP_PASSWORD	Contraseña de aplicación (WebDAV)
NEXTCLOUD_VAULT_PATH	Carpeta del vault (ej. /Cerebro Digital)
HERMES_AUTH_TOKEN	Token secreto que va dentro de la URL del MCP
HERMES_PORT	Puerto interno (por defecto 8080)
HERMES_REFRESH_MINUTES	Frecuencia de re-indexado (por defecto 10)

Despliegue (EasyPanel)

Se despliega como app desde este repositorio (Dockerfile). EasyPanel compila la imagen, inyecta las variables de entorno y publica el servicio con HTTPS en un subdominio.

La URL final del conector MCP es:

https://<subdominio>/<HERMES_AUTH_TOKEN>/mcp

Esa URL se agrega en Claude como conector personalizado (MCP remoto).

Desarrollo local

python -m venv .venv
.venv/Scripts/pip install -r requirements.txt   # Windows
# exportar las variables de entorno y:
python server.py