Wiki.js MCP Server
MCP-Server für Wiki.js: Seiten über die GraphQL-API erstellen, lesen, suchen, aktualisieren, verschieben und löschen. Node.js, stdio, 7 Tools.
Veraltet für Claude Code: Die manuelle Installation dieses Servers (Klonen, Bauen, Konfigurieren) ist für Claude Code veraltet. Nachfolger ist das Python-basierte wikijs-plugin. Für andere MCP-Clients bleibt dieser Server verfügbar und wird weiter gepflegt.
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 ersetzt ihn 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.