# Serveur MCP DokuWiki Passerelle Model Context Protocol entre Cursor et l'API JSON-RPC DokuWiki, selon `conception.md`. ## Prérequis - Python 3.13 - [uv](https://docs.astral.sh/uv/) - Accès HTTP(S) à l'instance DokuWiki ## Configuration Copier `.env.example` vers `.env` : ```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 ```bash uv sync --group dev ``` ## Exécution ```bash 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 ```bash uv run pytest ```