BookStack MCP Server

================================================================================ 📚 BookStack MCP Server - YOUR NEXT STEPS ================================================================================ Your BookStack MCP server is installed at: /home/borjigin/dev/bookstack-mcp/ ┌──────────────────────────────────────────────────────────────────────────┐ │ │ │ 🎯 COMPLETE THESE 4 STEPS (Takes 2 minutes) │ │ │ └──────────────────────────────────────────────────────────────────────────┘ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ STEP 1: Get BookStack API Token ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1. Open in browser: http://192.168.1.193:6875 2. Login to BookStack 3. Click your profile → "Edit Profile" 4. Go to "API Tokens" tab 5. Click "Create Token" 6. Give it a name: "Cursor MCP" 7. COPY both Token ID and Token Secret ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ STEP 2: Configure Environment ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Run this command: cd /home/borjigin/dev/bookstack-mcp && ./setup_env.sh Or manually create .env: cd /home/borjigin/dev/bookstack-mcp cp env.template .env nano .env Then paste your Token ID and Token Secret into .env ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ STEP 3: Test Connection ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Run this command: cd /home/borjigin/dev/bookstack-mcp && ./test_connection.py You should see: ✅ BookStack is reachable ✅ API authentication successful! ✅ All tests passed! ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ STEP 4: Configure Cursor ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Open Cursor → Settings (Ctrl+,) → Search "MCP" → Add Server Configure: Name: bookstack Command: /home/borjigin/dev/bookstack-mcp/run_server.sh Or edit ~/.config/cursor/mcp_settings.json and add: { "mcpServers": { "bookstack": { "command": "/home/borjigin/dev/bookstack-mcp/run_server.sh" } } } Then RESTART Cursor completely. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ STEP 5: Test in Cursor ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Open a new Cursor chat and type: "List all books in my BookStack" or "Search for 'docker' in BookStack" If you see results, YOU'RE ALL SET! 🎉 ┌──────────────────────────────────────────────────────────────────────────┐ │ │ │ 📖 WHAT YOU CAN DO NOW │ │ │ │ • "List all books" │ │ • "Search for 'kubernetes' in BookStack" │ │ • "Create a book called 'API Documentation'" │ │ • "Show me page 42" │ │ • "Create a page about Docker in book 5" │ │ • "Update page 10 with new content..." │ │ │ └──────────────────────────────────────────────────────────────────────────┘ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📚 DOCUMENTATION ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ INSTALLATION_SUMMARY.md - What was just installed QUICKSTART.md - Fast setup guide README.md - Complete documentation PROJECT_OVERVIEW.md - Architecture and design ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🔧 TROUBLESHOOTING ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Problem: Server won't start Solution: Run ./test_connection.py for diagnostics Problem: Can't connect to BookStack Solution: Check if BookStack is running: curl http://192.168.1.193:6875 Problem: Permission denied Solution: chmod +x *.sh *.py Problem: Cursor doesn't show tools Solution: 1. Verify .env has correct credentials 2. Check Cursor MCP settings 3. Restart Cursor completely ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ START HERE → Run: cd /home/borjigin/dev/bookstack-mcp && ./setup_env.sh ================================================================================