Audit-Report: KRITISCHE INKOHÄRENZ in /mcp/mcp-db/mcp-db-installation (Pfade, .env, DB-Namen)
| ID | 704 |
|---|---|
| Status | pending |
| Typ | human_task |
| Erstellt von | mcp-tasks (ai) |
| Erstellt | 2026-01-01 01:46:52.988018 |
Beschreibung
**Audit-Ergebnis für die Dokumentation: `/mcp/mcp-db/mcp-db-installation`**
**Parent-Task:** #655
**Bewertung:** **KRITISCH INKOHÄRENT UND FALSCH.** Die Installationsanleitung enthält mehrere fundamentale Fehler, die eine korrekte Einrichtung des MCP-DB Servers verhindern würden.
**Checklisten-Status:**
* **1. Terminologische Konsistenz:** ✅ OK
* **2. Technische Konsistenz:** ❌ **Nicht erfüllt.**
* [❌] **CRITICAL: Falscher Installationspfad:** Die gesamte Dokumentation verwendet `/opt/mcp-servers/mcp-db/` als Installationspfad. Der korrekte Pfad ist `/var/www/mcp-servers/mcp_db/`. Dies betrifft alle Befehle zur Verzeichnis-Erstellung, Virtual Environment Setup, Dateistruktur-Anzeige und Server-Registrierung. (Siehe auch Task #694 im übergeordneten `/mcp` Dokument).
* [❌] **Inkonsistente `.env` Dateien:** Die Dokumentation beschreibt die Erstellung einer `.env` Datei in `/opt/mcp-servers/mcp-db/`, jedoch sind diese Dateien nicht im tatsächlichen Verzeichnis vorhanden (siehe Task #697). Dies führt zu fehlenden Datenbank-Credentials beim Serverstart.
* [❌] **Inkonsistente Datenbanknamen:** Bei der Beschreibung der DB-User-Erstellung wird `ki_protokoll` verwendet, während das übergeordnete Dokument `/mcp/mcp-db` für Logging `ki_dev.mcp_log` angibt und die MCP-Tools `ki_dev` und `ki_content` nutzen. Dies schafft Verwirrung bei der Datenbankzuordnung.
* [✅] Der `mcp-db.service` existiert.
* **3. Strukturelle und Formale Konsistenz:** ✅ OK
* **4. Konzeptuelle Kohärenz:** ❌ **Nicht erfüllt.** Der Kernprozess der Installation ist aufgrund der falschen Pfade und der fehlerhaften `.env` Konfiguration inkohärent.
* **5. Prozessuale Kohärenz:** ❌ **Nicht erfüllt.** Das Befolgen der Installationsschritte würde zu einem nicht funktionierenden Setup führen.
* **6. Referentielle Integrität:** ✅ OK
* **7. Aktualität und Status-Konsistenz:** ❌ **Nicht erfüllt.** Die Installationsanleitung ist veraltet und falsch.
**Zu tätigende Korrekturen:**
1. **Installationspfade korrigieren:** Alle Verweise auf `/opt/mcp-servers/mcp-db/` müssen in `/var/www/mcp-servers/mcp_db/` geändert werden.
2. **`.env` Konfiguration klären:** Es muss klar dokumentiert werden, wo die `.env` Datei für die MCP-DB Server erwartet wird und wie sie richtig konfiguriert wird (ggf. zentrale `.env` im Projekt-Root referenzieren oder lokale `.env` sicherstellen).
3. **Datenbanknamen klären:** Die Referenzen auf Datenbanknamen (`ki_protokoll` vs. `ki_dev`) müssen konsistent sein. Wenn `ki_protokoll` ein Alias für `ki_dev` ist, sollte dies klar dokumentiert werden.
**Task-Status:** **OFFEN**. Aufgrund der kritischen Diskrepanzen, die eine korrekte Installation verhindern, bleibt dieser Task offen.