Wiki.js MCP Server

Model Context Protocol Server für die Wiki.js-Integration – Erstellen und verwalten Sie Wiki-Seiten direkt über Ihren KI-Assistenten.

Verwenden Sie dies mit Claude Code? Nutzen Sie stattdessen wikijs-plugin – es kombiniert diesen Server (portiert nach Python) mit einer docs-wiki-Fähigkeit zu einem einzigen Plugin, das über den Claude Code-Marktplatzmechanismus installierbar ist, ohne manuelle Klon-/Build-/Konfigurations- schritte. Die Konfiguration wechselt von der .env dieses Repos zu ~/.wikijs-plugin/.env (einrichten über /wikijs-plugin:setup); die Laufzeitumgebung ändert sich von Node.js 18+ zu Python 3.11+; Toolnamen (wikijs_create_page, ...) bleiben unverändert. Dieses Repo erhält weiterhin Fehlerbehebungen und bleibt die Möglichkeit, den Server direkt auszuführen (siehe Quick Start unten) für jeden anderen MCP-Client als Claude Code.

Migration einer bestehenden Installation: Kopieren Sie ~/.claude/mcp-servers/wikijs/.env nach ~/.wikijs-plugin/.env (gleiche Schlüssel, gleiche Werte – kein neuer API-Token erforderlich), entfernen Sie dann den alten wikijs-Eintrag aus ~/.claude.json, damit die Tools nicht doppelt registriert werden.

v2.0.0 – Große Überarbeitung

Diese Version enthält eine vollständige Neufassung nach den MCP-Best Practices:

• TypeScript – Vollständige Typsicherheit mit Strict Mode

• Modernes SDK – Verwendet MCP SDK v1.24+ mit der McpServer.tool()-API

• Zod-Validierung – Laufzeit-Eingabevalidierung für alle Tools

• Service-Präfix-Tools – Alle Tools verwenden das Präfix wikijs_ für Namensraum-Klarheit

• Tool-Anmerkungen – Korrekte readOnlyHint, destructiveHint usw.

• Paginationsunterstützung – Listenoperationen geben has_more, next_offset, total_count zurück

• Zeichenbegrenzungen – Große Inhalte werden mit eindeutigen Hinweisen abgeschnitten

Related MCP server: WikiJS MCP Server

Dokumentation

Vollständige Dokumentation & FAQ

Der umfassende Leitfaden umfasst:

• Installationsanleitung

• Konfigurationsbeispiele

• Alle 7 MCP-Tools mit Parametern

• Details zur GraphQL-API-Integration

• Fehlerbehebungsanleitung

Quick Start

Für jeden anderen MCP-Client als Claude Code (siehe Hinweis oben für Claude Code):

# 1. Clone repository
git clone https://github.com/markus-michalski/wikijs-mcp-server.git
cd wikijs-mcp-server

# 2. Install dependencies
npm install

# 3. Build TypeScript
npm run build

# 4. Configure environment
cp .env.example .env
# Edit .env with your Wiki.js API credentials

# 5. Point your MCP client's config at dist/index.js and restart it

Voraussetzungen

• Node.js 18+

• Wiki.js-Instanz (v2.x oder v3.x)

• Wiki.js-API-Token mit Berechtigungen zur Seitenverwaltung

Verfügbare Tools

Entwicklung

# Development with hot-reload
npm run dev

# Build for production
npm run build

# Type checking
npm run typecheck

Projektstruktur

wikijs-mcp-server/
├── src/
│   ├── index.ts           # Main server entry point
│   ├── constants.ts       # Shared constants (CHARACTER_LIMIT, etc.)
│   ├── types.ts           # TypeScript type definitions
│   ├── schemas/           # Zod validation schemas
│   ├── services/          # API client and error handling
│   └── tools/             # Tool implementations
├── dist/                  # Compiled JavaScript
├── evaluation.xml         # MCP evaluation test questions
└── package.json

Lizenz

MIT-Lizenz – Siehe LICENSE für Details

Autor

Markus Michalski

• Webseite: markus-michalski.net

• GitHub: @markus-michalski

Links

• Vollständige Dokumentation (Englisch)

• Vollständige Dokumentation (Deutsch)

• Changelog