homelab-brain/infra/hermes/README.md
2026-07-16 18:33:56 +02:00

51 lines
1.8 KiB
Markdown

# Hermes MCP-Server (versioniert)
Python stdio MCP-Server fuer den Hermes-Gateway auf **CT151** (pve-mu-3).
Laufort: `/root/.hermes/*.py` + Eintrag in `/root/.hermes/config.yaml` unter `mcp_servers:`.
## garage_decke
Brunnen/PWT/KaelteDecke aus InfluxDB CT143 (`sensors`, `node=garage_decke`).
| Datei | Tools |
|-------|-------|
| `garage_decke_mcp.py` | `garage_decke_live`, `garage_decke_compare` |
Ausfuehrliche Doku: `docs/projekte/garage-decke-monitoring.md`
### Deploy
```bash
# vom Repo auf pve-hetzner:
cd /root/homelab-brain
pct push 151 infra/hermes/garage_decke_mcp.py /root/.hermes/garage_decke_mcp.py
pct exec 151 -- chmod +x /root/.hermes/garage_decke_mcp.py
pct exec 151 -- systemctl restart hermes-gateway
```
`config.yaml`-Block und Env-Variablen siehe Projektdoku.
## homelab
Heizung/PV/Raumtemps MCP fuer Hermes (CT151).
| Datei | Tools |
|-------|-------|
| `homelab_mcp.py` | `heizung_now`, `heizung_brenner`, `heizung_kessel`, `heizung_history`, `pv_now`, `pv_history`, `homelab_status`, `homelab_measurements`, `homelab_query`, `raumtemps` |
Deploy analog `garage_decke_mcp.py` nach `/root/.hermes/homelab_mcp.py`, dann `systemctl restart hermes-gateway`.
Heizungs-HTTP-API: `infra/heizung-api/pruefstand_web.py` auf pve-mu-3 (`pruefstand-web.service`, Port 8765).
## shelly_mcp.py (16.07.2026)
Tools: `shelly_list`, `shelly_status`, `shelly_cover`, `shelly_pulse`.
Safety: Bad unten Bewegung gesperrt; Tor/Tuersummer nur `confirm=true` und nie in Cron (`HERMES_CRON_SESSION`).
Deploy-Ziel CT151: `/root/.hermes/shelly_mcp.py` + `mcp_servers.shelly` in config.yaml.
### Neue Shellys anbinden
Siehe CT999: `/root/docs/projekte/shelly-inventar.md` Abschnitt **Neue Shellys anbinden (Runbook)**.
Kurz: `DEVICES` in `shelly_mcp.py` erweitern, Hook-IP falls noetig, push + Deploy CT151, Gateway-Restart.