Installation

Voraussetzungen

• Docker (beliebig) installiert
• DokuWiki-Instanz mit aktivierter JSON-RPC-API (Remote-User: 1)
• JWT Bearer-Token für die DokuWiki-API

Docker-Image

Das Image ist im Gitea Container Registry verfügbar:

docker pull git.satware.ai/satware.ai/mcp-dokuwiki:latest

Das Image unterstützt linux/amd64 und linux/arm64 (Multi-Arch-Build).

Umgebungsvariablen

Variable	Erforderlich	Standard	Beschreibung
DOKUWIKI_URL	ja	-	DokuWiki-Instanz URL (z.B. https://wiki.satware.com)
DOKUWIKI_TOKEN	ja	-	JWT Bearer-Token für API-Zugriff
DOKUWIKI_DEFAULT_NAMESPACE	nein	(leer)	Standard-Namensraum für neue Seiten
DEBUG	nein	false	"true" aktiviert Debug-Logging
LOG_LEVEL	nein	info	Log-Level (error, warn, info, debug)

Token-Generierung

DokuWiki 2024-02-06b “Kaos” hat integrierte JWT-Unterstützung. Generieren Sie einen Token im DokuWiki-Container:

$token = \dokuwiki\JWT::fromUser("admin");
$token->save();
echo $token->getToken();

Container starten

Manueller Test (Health Check)

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1"}}}' \
| docker run -i --rm \
    -e DOKUWIKI_URL=https://wiki.satware.com \
    -e DOKUWIKI_TOKEN=YOUR_TOKEN \
    git.satware.ai/satware.ai/mcp-dokuwiki:latest

Erwartete Antwort: JSON mit "result" und "serverInfo".

Mit MCP-Client (TypingMind)

Der Server verwendet stdio-Transport. Der TypingMind MCP Proxy (@typingmind/mcp) startet den Container pro Sitzung:

docker run -i --rm \
  -e DOKUWIKI_URL \
  -e DOKUWIKI_TOKEN \
  -e DOKUWIKI_DEFAULT_NAMESPACE \
  -e DEBUG \
  git.satware.ai/satware.ai/mcp-dokuwiki:latest

Die Umgebungsvariablen werden vom Proxy aus den Plugin-userSettings gesetzt. Siehe Schnellstart für die TypingMind-Konfiguration.

DokuWiki konfigurieren

Einstellung	Wert	Beschreibung
remote	1	JSON-RPC-API aktivieren
remoteuser	@user	Nur authentifizierte Benutzer

Die API ist erreichbar unter https://your-wiki/lib/exe/jsonrpc.php.

Versionierung

Das Image folgt Semantic Versioning. Tags werden automatisch durch semantic-release im GitLab CI erstellt. Die Version wird zur Laufzeit über git describe ermittelt - keine hartcodierten Versionsstrings im Image.