Hermes VPS
Hermes Agent (NousResearch) runs on VPS 187.127.24.217 via Docker Compose at /home/hermes — how to configure MCP and where files live
Hermes Agent (github.com/NousResearch/hermes-agent) hosted on user's VPS.
- SSH:
root@187.127.24.217 - Path:
/home/hermes/(Dockerfile, docker-compose.yml, entrypoint.sh, apply_patches.py) - Config/state volume:
/home/hermes/hermes-home/→ mounted as/root/.hermesinside containers - Containers:
hermes-gateway(Discord bot + cron),hermes-dashboard(port 9119)
VPS shared infra (descoberto 2026-04-22):
- Reverse proxy: nginx native no host (NÃO Traefik). Configs em
/etc/nginx/. - Portas usadas: 3000 (lunacrm-web), 3030 (excalidraw), 3100 (agent-scraper), 4000-4001 (lunacrm-api), 8080 (evolution), 9119 (hermes-dashboard). Internas só localhost: 3001 (grafana), 8081 (cadvisor), 8888 (dozzle), 9090 (prom), 9100 (node-exporter).
- LunaCRM rodando em prod no VPS (containers
lunacrm-*+ evolution-api + redis + grafana + prometheus). Imagens GHCRkodama1/lunacrm-*. - Outros: agent-scraper-1 (3100), vigilant_noether (evolution v2.1.1 órfão).
- Disco: 96G total, 71G livres.
- Main config:
/home/hermes/hermes-home/config.yaml - Logs:
/home/hermes/hermes-home/logs/{agent,errors}.log(docker logs are noisy/unreliable — prefer these) - Python venv inside container:
/app/venv— activate before running hermes internals /appinside container = cloned hermes-agent repo
Adding MCP servers: append mcp_servers: block to config.yaml. Requires mcp pip pkg in venv (uv pip install mcp). Already baked into Dockerfile. npx available for stdio MCP servers. After edit: docker restart hermes-gateway.
Current MCPs configured:
linear—npx -y @tacticlaunch/mcp-linearwithLINEAR_API_KEYexcalidraw—node /usr/lib/node_modules/mcp-excalidraw-server/dist/index.jspointing at sibling containerexcalidraw-canvas:3000(host port 3030). NPM bin wrapper symlink doesn't work because the script'simport.meta.url === process.argv[1]entrypoint check fails on symlinks — always callnodeon the resolved path.
Canvas UI: http://187.127.24.217:3030. Canvas container built from /home/excalidraw (cloned from github.com/yctimlin/mcp_excalidraw via docker build -f Dockerfile.canvas -t mcp-excalidraw-canvas:local .).
To verify MCP discovery manually: docker exec hermes-gateway bash -c 'source /app/venv/bin/activate && cd /app && python -c "from tools.mcp_tool import discover_mcp_tools, get_mcp_status; print(discover_mcp_tools()); print(get_mcp_status())"'