mrcrunchouille/bookstack-mcp-server repository overview

⁠🚀 BookStack MCP Server

Serveur Model Context Protocol (MCP) permettant aux LLMs (Claude, GPT, etc.) d'interagir avec votre instance BookStack via son API REST.

Par défaut, le serveur n'expose qu'un ensemble restreint d'outils essentiels au LLM afin de réduire la surface d'action et les risques. L'ensemble des 50+ outils reste disponible côté API, et l'exposition au LLM est configurable (whitelist/curation recommandée).

⁠📋 Overview Rapide

Ce serveur MCP expose 50+ outils pour gérer complètement votre instance BookStack :

• 📚 Livres, Chapitres, Pages : CRUD complet + Export (HTML, PDF, Markdown)
• 📁 Étagères, Images, Pièces jointes : Gestion complète
• 👥 Utilisateurs et Rôles : Administration
• 🔍 Recherche, Permissions, Audit : Fonctionnalités avancées

Mode multi-utilisateurs : Chaque utilisateur s'authentifie avec ses propres tokens BookStack via headers HTTP.

⁠🏷️ Tags Disponibles

⁠🚀 Déploiement Rapide

# Déploiement basique (port 3000)
docker run -d --name bookstack-mcp -p 3000:3000 \
  mrcrunchouille/bookstack-mcp-server:latest

# Avec port personnalisé
docker run -d --name bookstack-mcp -p 8080:3000 \
  mrcrunchouille/bookstack-mcp-server:latest

# Avec restart automatique
docker run -d --name bookstack-mcp -p 3000:3000 \
  --restart unless-stopped \
  mrcrunchouille/bookstack-mcp-server:latest

⁠⚙️ Configuration

Le serveur écoute sur le port 3000 par défaut (configurable via MCP_PORT).

Chaque utilisateur configure ses tokens BookStack dans Cursor via cline_mcp_settings.json :

{
  "mcpServers": {
    "bookstack": {
      "url": "http://127.0.0.1:3000/mcp",
      "transport": "http",
      "headers": {
        "X-BOOKSTACK-URL": "https://wiki.example.com",
        "X-BOOKSTACK-TOKEN-ID": "VOTRE_TOKEN_ID",
        "X-BOOKSTACK-TOKEN-SECRET": "VOTRE_TOKEN_SECRET"
      }
    }
  }
}

⁠📚 Documentation Complète

• GitHub : https://github.com/Sakrefyohan/MCP-BookStack⁠
• Documentation API BookStack : https://www.bookstackapp.com/docs/admin/api/⁠

⁠🔧 Variables d'Environnement

⁠🧪 Tests

# Health check
curl http://localhost:3000/health

# Vérifier la racine
curl http://localhost:3000/

⁠📝 Licence

MIT

⁠👤 Mainteneur

MrCrunchouille

Développé pour BookStack + Cursor IDE + Model Context Protocol (MCP)