Zum Inhalt

Homelab MCP – Mehrere Wikis

Stand 15.10.2026: Seit Version 0.7.0 kann homelab-mcp (CT 109) mehrere Git-Wikis bedienen. Eingerichtet sind:

ID Repository Branch Dokumentordner Verwendung
default git@github.com:HerrBausW/smarthome-wiki.git master docs Smart-Home-Wiki (Standard)
reise git@github.com:HerrBausW/reise-wiki.git main src/content Reise-Wiki (Astro-Projekt)

Nutzung über MCP

  • Alle Wiki-Tools (wiki_list, wiki_read, wiki_write, wiki_delete, wiki_sync) haben den optionalen Parameter wiki. Ohne Angabe wird default verwendet.
  • wiki_list_wikis zeigt die eingerichteten Wikis mit Repository, Branch und Dokumentordner.
  • Unbekannte IDs werden abgelehnt. Die Tool-Freigaben (auch wiki_delete) gelten für das Wiki-Plugin insgesamt, also für alle Wikis.
  • Clients müssen den Connector aktualisieren, bevor wiki_list_wikis und der Parameter wiki sichtbar werden (Tool-Cache).

Einrichtung

Admin-Oberfläche → Einrichtung → Wiki → „Weiteres Wiki hinzufügen":

  1. Wiki-ID (Kleinbuchstaben, Ziffern, Bindestrich), Repository, Branch und Dokumentordner eintragen. Erlaubte Root-Dateien leer lassen, wenn es keine Index-Datei wie mkdocs.yml gibt.
  2. „Schlüssel erzeugen" und den öffentlichen Schlüssel im Repository unter Deploy keys mit Schreibrecht eintragen.
  3. „Hostschlüssel abrufen" und die Fingerprints mit einer unabhängigen Quelle vergleichen (GitHub: https://api.github.com/meta, Feld ssh_key_fingerprints).
  4. „Wiki verbinden". Der MCP-Dienst wird dabei neu gestartet; die lokale Kopie legt er beim ersten Zugriff selbst an.

Dateien auf CT 109:

/etc/homelab-mcp/wiki.json                  # {"default": "default", "wikis": {...}}
/etc/homelab-mcp/wikis/<id>/                # Deploy-Key, known_hosts
/var/lib/homelab-mcp/wikis/<id>/            # lokale Kopie

Das Smart-Home-Wiki liegt unverändert unter /etc/homelab-mcp/wiki/ und /var/lib/homelab-mcp/wiki/.

Entfernen

„Entfernen" in der Liste löscht den Eintrag, den Deploy-Key und die Hostschlüssel. Das Repository und die lokale Kopie auf dem Server bleiben unverändert. Das Standard-Wiki lässt sich nicht entfernen.

Git-Autor

Commits des MCP erscheinen als „Homelab MCP homelab-mcp@localhost.invalid". Name und Adresse sind pro Wiki unter „Weitere Wiki-Einstellungen" änderbar; .invalid ist eine reservierte Domain ohne echte Adresse.

Geprüft am 15.10.2026

  • Reise-Wiki auflisten und lesen.
  • Testseite src/content/_mcp2-test.md schreiben (Commit und Push) und wieder löschen (Commit und Push). Dateien mit Unterstrich-Präfix werden von Astro ignoriert.
  • Smart-Home-Wiki weiterhin unverändert nutzbar.

Verwandt: Parität zu MCP1, Admin-Dienst