Bez popisu

Intersel 2825284df6 update sur le titrage attendu dans dokuwiki před 4 týdny
.cursor 2825284df6 update sur le titrage attendu dans dokuwiki před 4 týdny
src 2825284df6 update sur le titrage attendu dans dokuwiki před 4 týdny
.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 2825284df6 update sur le titrage attendu dans dokuwiki před 4 týdny
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.

Conventions de rédaction

Le serveur transmet ses conventions aux clients MCP via les instructions de l'initialisation (src/dokuwiki_mcp/mcp/server.py, constante INSTRUCTIONS) ; elles sont rappelées dans la description des outils d'écriture. En résumé :

  • syntaxe DokuWiki uniquement, pas de Markdown ;
  • titre principal en niveau 1 (====== Titre ======), nommant le projet concerné ;
  • sections suivantes en niveau 1 numérotées (====== - Section ======), sans passer au niveau 2 juste après le titre principal ; sous-sections en ===== puis ==== ;
  • un sujet par page, sous-pages seulement sur demande.

Pour modifier ces conventions, éditer INSTRUCTIONS dans server.py et la règle .cursor/rules/dokuwiki.mdc.

Tests

uv run pytest