|
|
4 hete | |
|---|---|---|
| .cursor | 4 hete | |
| src | 4 hete | |
| .cursorignore | 2 hónapja | |
| .env.example | 2 hónapja | |
| .gitignore | 2 hónapja | |
| README.md | 4 hete | |
| pyproject.toml | 2 hónapja | |
| uv.lock | 2 hónapja |
Passerelle Model Context Protocol entre Cursor et l'API JSON-RPC DokuWiki, selon conception.md.
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).
src/
├── config/ # Initialisation (.env, validation, démarrage)
├── mcp/ # tools.py, resources.py, moteur FastMCP
└── services/ # ClientHTTP + cache pages
uv sync --group dev
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.
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 dessousdokuwiki://media/{id} — contenu médiasave_page et append_page invalident le cache de la page écrite.
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é :
====== Titre ======), nommant le projet concerné ;====== - Section ======), sans passer au niveau 2 juste après le titre principal ; sous-sections en ===== puis ==== ;Pour modifier ces conventions, éditer INSTRUCTIONS dans server.py et la règle .cursor/rules/dokuwiki.mdc.
uv run pytest