Consolidate portable MCPs in Unraid MCPHub

README.md

@@ -1,24 +1,29 @@
 # Athena AI
 
-Ein reproduzierbarer Docker-Stack für Athenas lokale KI. Ein Compose-Projekt
-enthält Router, llama.cpp-Profile, OpenWebUI, Hermes, Sprache, Bildgenerierung,
-fachliche MCP-Container und das regelmäßige Datenbackup.
+Ein reproduzierbarer Docker-Stack für Athenas lokale KI. Athena stellt Router,
+llama.cpp-Profile, OpenWebUI, Hermes, Sprache und Bildgenerierung bereit. Die
+portablen Werkzeuge laufen zentral im MCPHub auf Unraid und werden dort zusammen
+mit dem übrigen Appdata gesichert.
 
 ## Aufbau
 
-- `compose.yaml` ist der einzige Einstieg; `platform/mcp/compose.yaml` wird mit
-  Docker Composes standardisiertem `include` in dasselbe Projekt geladen.
+- `compose.yaml` ist der einzige Einstieg für die KI-Dienste auf Athena.
 - Genau ein llama.cpp-Profil ist aktiv. Der Router schaltet zwischen Fast,
   Medium, Large, Ultra und Uncensored.
-- Der **Athena Operator** ist der einzige administrative MCP. Er liefert mit
-  `athena_operator_inspect(subject=guide)` auch diese Plattformanleitung aus
-  `ATHENA.md`.
-- Home Assistant, ARR, Unraid, Navidrome, Deemix, GitHub und Web bleiben als
-  getrennte Fach-MCPs isolierbar und unabhängig aktualisierbar.
+- Der **Athena Operator** bleibt während der Migration der einzige
+  hostgebundene administrative MCP. Er wird anschließend durch einen
+  SSH-basierten Operator im MCPHub ersetzt.
+- 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.
-- Modelle, Hermes-Daten und Backups liegen auf `/data`; Secrets ausschließlich
-  unter `/etc/mike-ai`.
+- Modelle, Hermes-Daten und Athena-Backups liegen auf `/data`. MCPHub-Zustand,
+  Client-Schlüssel und MCP-Zugänge liegen im Unraid-Appdata-Verzeichnis
+  `/mnt/nvme-storage/appdata/MCPHub`.
 - KI-Oberflächen und APIs sind nur über WireGuard erreichbar.
 
 ## Installation – ein Befehl
@@ -38,8 +43,8 @@ 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 Änderung ausrollen
-docker compose --env-file /etc/mike-ai/stack.env up -d --build mcp-arr
+# Eine gezielte Athena-Komponente ausrollen
+docker compose --env-file /etc/mike-ai/stack.env up -d --build router
 
 # Sofortiges Datenbackup zusätzlich zum Fünf-Stunden-Zeitplan
 docker exec mike-ai-backup backup
@@ -68,4 +73,7 @@ Details, Prüfschritte und der exakte Sicherungsumfang stehen in
 - [`docs/STANDARD_PROFILE_MATRIX.md`](docs/STANDARD_PROFILE_MATRIX.md) – Profile und Messwerte
 - [`docs/RECOVERY.md`](docs/RECOVERY.md) – Backup und Neuaufbau
 
+Die MCPHub-Installation, Endpunkte und der schrittweise Rückbau der alten
+Athena-MCPs stehen in [`platform/mcphub/README.md`](platform/mcphub/README.md).
+
 Git enthält keine Secrets, Chatdaten oder Modellgewichte.