Подключите BookStack к Claude и другим AI-ассистентам через протокол Model Context Protocol (MCP). Этот сервер предоставляет 59 инструментов и 11 ресурсов, охватывающих поддерживаемый поднабор API BookStack — книги, страницы, главы, полки, поиск, пользователи, роли, разрешения, вложения, изображения, корзину для переработки, журнал аудита и системную информацию.

Этот сервер поддерживает два режима транспорта: Streamable HTTP (по умолчанию) и Stdio.

• Потоковый HTTP (по умолчанию): Безсостоятельный HTTP-транспорт. Параметры аутентификации могут быть перезаписаны по запросу с помощью HTTP-заголовков (x-bookstack-url и x-bookstack-token).
• Stdio Mode: Стандартный ввод/вывод для локальной интеграции (например, с Claude Desktop). Установите MCP_TRANSPORT=stdio на включение.

⚠️ Ищете HTTP-конечную точку? Конечная точка MCP — это POST /message — а не /. См. ниже раздел «Транспортные и HTTP-конечные точки».

✨ Что ты получаешь

• Интеграция с BookStack - Доступ к вашим книгам, страницам, главам и контенту
• 59 MCP Tools и 11 ресурсов — CRUD, поиск и экспорт между поддерживаемыми семействами конечных точек
• Поиск и экспорт - Поиск контента и экспорт в различных форматах
• Управление пользователями — обработка пользователей, ролей и разрешений

BookStack MCP Server

Connect BookStack to Claude and other AI assistants through the Model Context Protocol (MCP). This server exposes 59 tools and 11 resources covering the supported subset of the BookStack API — books, pages, chapters, shelves, search, users, roles, permissions, attachments, images, the recycle bin, the audit log and system info.

This server supports two transport modes: Streamable HTTP (default) and Stdio.

• Streamable HTTP (default): A stateless HTTP transport. Authentication parameters can be overridden per-request using HTTP headers (x-bookstack-url and x-bookstack-token).
• Stdio Mode: Standard input/output for local integration (e.g., with Claude Desktop). Set MCP_TRANSPORT=stdio to enable.

⚠️ Looking for the HTTP endpoint? The MCP endpoint is POST /message — not /. See Transports and HTTP endpoints below.

✨ What You Get

• BookStack Integration - Access your books, pages, chapters, and content
• 59 MCP Tools & 11 Resources - CRUD, search and export across the supported endpoint families
• Search & Export - Find content and export in multiple formats
• User Management - Handle users, roles, and permissions
• Production Ready - Rate limiting, validation, error handling, and logging

🚀 Quick Start

⚠️ Requires Bun 1.1.0 or newer. Node.js is not supported. This package ships TypeScript source rather than a compiled bundle, and its executable starts with #!/usr/bin/env bun — Bun must be installed on the machine that runs it. npx/npm install -g will not work.

Configure first — the default HTTP transport refuses to start until both tokens below are set:

# 1. Configure
export BOOKSTACK_BASE_URL="https://your-bookstack.com/api"
export BOOKSTACK_API_TOKEN="token_id:token_secret"   # OUTBOUND: the credential this server spends
export MCP_AUTH_TOKEN="$(openssl rand -hex 32)"      # INBOUND: who may make it spend that credential

# 2. Run without installing (starts the HTTP server on port 3000)
bunx bookstack-mcp-server

# Or install globally, then run it by name
bun add -g bookstack-mcp-server
bookstack-mcp-server

The two tokens are not interchangeable and must not be set to the same value: BOOKSTACK_API_TOKEN is what the server presents to BookStack; MCP_AUTH_TOKEN is what callers must present to POST /message, which dispatches all 59 tools with the authority of the BookStack account behind BOOKSTACK_API_TOKEN. Skip MCP_AUTH_TOKEN only for stdio, which has no network surface and ignores it.

Check it started:

curl http://localhost:3000/          # => {"status":"running", ...}
curl -i http://localhost:3000/health # => 200 healthy, or 503 if BookStack is unreachable

Add to Claude

To use with Claude Desktop (requires Stdio mode):

# For Claude Code
claude mcp add bookstack bunx bookstack-mcp-server \