Installation

Prerequisites

• Docker (any recent version) installed
• DokuWiki instance with JSON-RPC API enabled (Remote User: 1)
• JWT Bearer token for the DokuWiki API

Docker Image

The image is available from the Gitea Container Registry:

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

The image supports linux/amd64 and linux/arm64 (multi-arch build).

Environment Variables

Variable	Required	Default	Description
DOKUWIKI_URL	yes	-	DokuWiki instance URL (e.g. https://wiki.satware.com)
DOKUWIKI_TOKEN	yes	-	JWT Bearer token for API access
DOKUWIKI_DEFAULT_NAMESPACE	no	(empty)	Default namespace for new pages
DEBUG	no	false	"true" enables debug logging
LOG_LEVEL	no	info	Log level (error, warn, info, debug)

Token Generation

DokuWiki 2024-02-06b “Kaos” has built-in JWT support. Generate a token inside the DokuWiki container:

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

Start the Container

Manual 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

Expected response: JSON with "result" and "serverInfo".

With MCP Client (TypingMind)

The server uses stdio transport. The TypingMind MCP Proxy (@typingmind/mcp) spawns the container per session:

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

Environment variables are set by the proxy from the plugin userSettings. See Quickstart for TypingMind configuration.

Configure DokuWiki

Setting	Value	Description
remote	1	Enable JSON-RPC API
remoteuser	@user	Authenticated users only

The API endpoint is at https://your-wiki/lib/exe/jsonrpc.php.

Versioning

The image follows Semantic Versioning. Tags are automatically created by semantic-release in GitLab CI. The version is determined at runtime via git describe - no hardcoded version strings in the image.