¶ Wiki.js MCP Server
Der Wiki.js MCP Server verbindet einen MCP-Client mit deiner Wiki.js-Instanz. Über die GraphQL-API von Wiki.js kann der Client Seiten erstellen, abrufen, auflisten, suchen, aktualisieren, verschieben und löschen.
Diese Seite beschreibt den eigenständigen Node.js-Server (Repository
wikijs-mcp-server). Für Claude Code gibt es als Alternative das wikijs-plugin mit Python-MCP-Server und Marketplace-Installation. Die sieben Tools dieses Servers tragen dort dieselben Namen; das Plugin bietet zusätzlich Tools für Änderungshistorie und verified-Marker (insgesamt 10 Tools) sowie Skills für geprüfte Doku.
¶ Auf einen Blick
- 7 Tools mit dem Präfix
wikijs_: erstellen, abrufen, auflisten, suchen, aktualisieren, löschen, verschieben - Transport: stdio, Authentifizierung per Bearer-Token gegen den GraphQL-Endpunkt deiner Wiki.js-Instanz
- Alle Eingaben werden mit Zod geprüft (Pfad-, Locale-, Tag- und Größenlimits)
- Konfiguration über zwei Umgebungsvariablen:
WIKIJS_API_URLundWIKIJS_API_TOKEN - Keine Telemetrie: der Server spricht ausschließlich mit der konfigurierten Wiki.js-URL
¶ Voraussetzungen
| Anforderung | Details |
|---|---|
| Node.js | 18 oder neuer (engines in der package.json; die CI testet 18, 20 und 22) |
| npm | zum Installieren der Abhängigkeiten und zum Bauen |
| Wiki.js | Instanz mit erreichbarer GraphQL-API (Endpunkt endet auf /graphql) |
| API-Key | Wiki.js-API-Key mit den Rechten read:pages, write:pages, manage:pages (laut .env.example) |
| MCP-Client | beliebiger Client, der stdio-Server starten kann |
¶ Dokumentation
| Seite | Inhalt |
|---|---|
| Installation | Klonen, Bauen, Client registrieren, aktualisieren, deinstallieren |
| Konfiguration | Umgebungsvariablen, Lade-Reihenfolge der .env, API-Key anlegen, feste Limits |
| Tools-Referenz | Alle 7 Tools mit Parametern, Rückgabe und Besonderheiten |
| Anwendung und Beispiele | Typische Abläufe und Beispielaufrufe |
| Sicherheit | Umgang mit dem Token, Logging, Rechte, Zerstörungspotenzial |
| Technische Details | Aufbau, GraphQL-Operationen, Fehlerbehandlung, Entwicklung |
| Fehlerbehebung | Meldungen und ihre Ursachen |
¶ Schnellstart
git clone https://github.com/markus-michalski/wikijs-mcp-server.git
cd wikijs-mcp-server
npm install
npm run build
cp .env.example .env
Trage in der .env die URL und den Token ein und lasse deinen MCP-Client node /pfad/zu/wikijs-mcp-server/dist/index.js starten. Wichtig ist, wo der Server die .env sucht: siehe Konfiguration.
¶ Lizenz
MIT, siehe LICENSE.