README.md 1.5 KB

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

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
  • 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