simplify Athena runtime and centralize MCP management

README.md

@@ -1,9 +1,8 @@
 # Athena AI
 
-Ein reproduzierbarer Docker-Stack für Athenas lokale KI. Athena stellt Router,
-llama.cpp-Profile, OpenWebUI, Sprache und Bildgenerierung bereit. Der offizielle
-Hermes Agent und die portablen Werkzeuge laufen auf Unraid und werden dort
-zusammen mit dem übrigen Appdata gesichert.
+Ein reproduzierbarer Docker-Stack für Athenas lokale Inferenz. Athena stellt
+Router, llama.cpp-Profile, Sprache und Bildgenerierung bereit. Der offizielle
+Hermes Agent und MCPHub laufen auf Unraid und werden dort mit Appdata gesichert.
 
 ## Aufbau
 
@@ -21,11 +20,10 @@ zusammen mit dem übrigen Appdata gesichert.
 - Home Assistant, ARR, Unraid, Navidrome, Deemix und GitHub laufen gemeinsam im
   MCPHub-Container auf Unraid, bleiben aber als getrennte MCP-Server unter
   `/mcp/NAME` sichtbar, abschaltbar und unabhängig für Clients freigebbar.
-- SearXNG/TinySearch dürfen als eigene Such-Backends laufen. Der eigentliche
-  Web-MCP-Adapter zieht ebenfalls in den MCPHub, sobald der Backend-Pfad aus dem
-  Unraid-Netz verfügbar ist.
-- `config/mcp-registry.json` ist die einzige Liste der MCPs für Hermes und
-  OpenWebUI. `platform/mcp/sync-clients.py` erzeugt beide Registrierungen.
+- Hermes verwendet für allgemeine Recherche seine integrierten Webwerkzeuge;
+  der frühere Athena-Webadapter wird nicht mehr gestartet.
+- `config/mcp-registry.json` ist die einzige Liste der MCPHub-Server und ihrer
+  Client-Registrierungen. `platform/mcp/sync-clients.py` erzeugt Hermes daraus.
 - Modelle und Athena-Backups liegen auf `/data`. Hermes liegt vollständig unter
   `/mnt/nvme-storage/appdata/Hermes-Agent`; MCPHub-Zustand, Client-Schlüssel und
   MCP-Zugänge liegen unter `/mnt/nvme-storage/appdata/MCPHub`.
@@ -43,7 +41,7 @@ sudo ./install.sh --config config/install.env
 ```
 
 Das Skript installiert Docker und NVIDIA-Unterstützung, lädt die konfigurierten
-Modelle, baut den Stack und startet die benötigten Profile und MCPs.
+Modelle und startet ausschließlich Athenas Inferenz-Kern plus Operator.
 
 ## Bedienung
 
@@ -51,14 +49,16 @@ Modelle, baut den Stack und startet die benötigten Profile und MCPs.
 # Gesamten Stack anzeigen
 docker compose --env-file /etc/mike-ai/stack.env ps
 
-# Eine gezielte Athena-Komponente ausrollen
-docker compose --env-file /etc/mike-ai/stack.env up -d --build router
+# Erst anzeigen, dann eine gezielte Komponente ohne Nebenwirkungen ausrollen
+./manage.sh --dry-run deploy router
+./manage.sh deploy router
 
 # Sofortiges Datenbackup zusätzlich zum Fünf-Stunden-Zeitplan
 docker exec mike-ai-backup backup
-```
 
-OpenWebUI: `http://<WireGuard-IP>:8080`
+# Kurzer read-only Ende-zu-Ende-Test nach jedem Release
+sudo ./smoke-test.sh
+```
 
 Router-API: `http://<WireGuard-IP>:8081/v1`
 
@@ -81,6 +81,7 @@ Details, Prüfschritte und der exakte Sicherungsumfang stehen in
 
 - [`ATHENA.md`](ATHENA.md) – kurze Maschinen- und Operatoranleitung
 - [`docs/STANDARD_PROFILE_MATRIX.md`](docs/STANDARD_PROFILE_MATRIX.md) – Profile und Messwerte
+- [`docs/MCP_SERVERS.md`](docs/MCP_SERVERS.md) – automatisch erzeugte MCP-Liste
 - [`docs/RECOVERY.md`](docs/RECOVERY.md) – Backup und Neuaufbau
 
 Die MCPHub-Installation, Endpunkte und der schrittweise Rückbau der alten