# 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.