Bez popisu

Khanh Nguyen a769e47443 update client add referer in header před 2 měsíci
.cursor 0d2f2ab28b add resource for get page backlinks před 2 měsíci
src a769e47443 update client add referer in header před 2 měsíci
.cursorignore 4601c278de init project před 2 měsíci
.env.example 2576ce8b2a update LRU and max entries in cache před 2 měsíci
.gitignore 4601c278de init project před 2 měsíci
README.md 2576ce8b2a update LRU and max entries in cache před 2 měsíci
pyproject.toml 4601c278de init project před 2 měsíci
uv.lock 4601c278de init project před 2 měsíci

README.md

Serveur MCP DokuWiki

Passerelle Model Context Protocol entre Cursor et l'API JSON-RPC DokuWiki, selon conception.md.

Prérequis

  • Python 3.13
  • uv
  • Accès HTTP(S) à l'instance DokuWiki

Configuration

Copier .env.example vers .env :

BASE_URL=https://votre-wiki.example.com
WIKI_USERNAME=votre_utilisateur
WIKI_PASSWORD=votre_mot_de_passe
CACHE_TTL=60
CACHE_MAX_ENTRIES=20

Le cache pages a un TTL (CACHE_TTL) et un plafond LRU (CACHE_MAX_ENTRIES, 20 par défaut).

Chaque requête envoie Authorization: Basic suivi de base64(username:password).

Le fichier .env ne doit pas être commité (.gitignore / .cursorignore).

Organisation

src/
├── config/       # Initialisation (.env, validation, démarrage)
├── mcp/          # tools.py, resources.py, moteur FastMCP
└── services/     # ClientHTTP + cache pages

Installation

uv sync --group dev

Exécution

uv run dokuwiki-mcp

Cursor charge le serveur via .cursor/mcp.json (stdio). Au démarrage, Initialisation.execute() valide le .env puis lance le moteur MCP.

Capacités

Outils : search_pages, save_page, append_page (réponse brute de l'API).

Ressources :

  • dokuwiki://pages/{namespace} — enfants directs (- = racine)
  • dokuwiki://page/{id} — texte wiki via le cache (TTL + plafond LRU)
  • dokuwiki://medias/{namespace} — médias du namespace et en dessous
  • dokuwiki://media/{id} — contenu média

save_page et append_page invalident le cache de la page écrite.

Tests

uv run pytest