Model Context Protocol(MCP)을 통해 BookStack을 Claude 및 기타 AI 어시스턴트와 연결합니다. 이 서버는 BookStack API의 지원 하위 집합을 아우르는 59개의 도구와 11개의 리소스를 노출합니다 — 책, 페이지, 장, 선반, 검색, 사용자, 역할, 권한, 첨부파일, 이미지, 휴지통, 감사 로그, 시스템 정보 등.

이 서버는 두 가지 전송 모드를 지원합니다: 스트림 가능한 HTTP(기본값)와 Stdio.

• 스트림 가능한 HTTP (기본값): 상태 없는 HTTP 전송입니다. 인증 매개변수는 HTTP 헤더(x-bookstack-url 및 x-bookstack-token)를 사용하여 요청당 덮어쓸 수 있습니다.
• Stdio 모드: 로컬 통합을 위한 표준 입출력(예: Claude Desktop 포함). MCP_TRANSPORT=stdio를 활성화하도록 설정하세요.

⚠️ HTTP 엔드포인트를 찾고 계신가요? MCP 엔드포인트는 POST /message이며 /가 아닙니다. 아래의 전송 및 HTTP 엔드포인트를 참조하세요.

✨ 네가 얻는 것들

• BookStack 통합 - 책, 페이지, 챕터, 콘텐츠 접근
• 59 MCP 도구 및 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 \