# 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
```bash
python -m venv .venv
.venv/Scripts/pip install -r requirements.txt   # Windows
# exportar las variables de entorno y:
python server.py
```