BookStack MCP サーバー

AI アシスタントが BookStack ドキュメントにフルアクセス（検索、読み取り、作成、コンテンツ管理）できるようにする Model Context Protocol (MCP) サーバーです。

npx bookstack-mcp

機能

• 20個の読み取り専用ツール + 18個の書き込みツールにより、BookStack API を完全にカバー

• 本、章、ページ、棚、添付ファイル、コメントの完全な CRUD 操作

• ゴミ箱サポート — 論理削除されたコンテンツの復元または完全削除

• Zod による型安全な入力バリデーション（幅広いクライアント互換性のために文字列/数値パラメータを自動変換）

• すべてのレスポンスに埋め込み URL とコンテンツプレビューを表示

• HTML で作成されたページに対する Markdown エクスポートフォールバックにより、AI クライアントが常に利用可能なコンテンツを取得可能

• 安全のため、書き込み操作はデフォルトで無効化

• Claude Desktop、Claude Code、LibreChat、および MCP 互換クライアントで動作

• Stdio および Streamable HTTP トランスポート

Related MCP server: PDF RAG MCP Server

クイックスタート

npm からインストール

npx bookstack-mcp

またはクローンしてビルド

git clone https://github.com/ttpears/bookstack-mcp.git
cd bookstack-mcp
npm install && npm run build
npm start

環境変数

BOOKSTACK_BASE_URL=https://your-bookstack.com   # Required
BOOKSTACK_TOKEN_ID=your-token-id                # Required
BOOKSTACK_TOKEN_SECRET=your-token-secret        # Required
BOOKSTACK_ENABLE_WRITE=false                    # Optional, default false
BOOKSTACK_INSECURE_SKIP_TLS_VERIFY=false        # Optional, default false

セキュリティ警告: BOOKSTACK_INSECURE_SKIP_TLS_VERIFY=true は、BookStack への送信リクエストに対する TLS 証明書の検証を無効にします。信頼できる LAN 上の自己署名証明書に対してのみ使用してください。接続が MITM 攻撃に対して脆弱になります。この設定が有効な場合、サーバーは起動時に WARNING ログを出力します。

クライアント設定

Claude Desktop

Claude Desktop の設定に追加します：

{
  "mcpServers": {
    "bookstack": {
      "command": "npx",
      "args": ["-y", "bookstack-mcp"],
      "env": {
        "BOOKSTACK_BASE_URL": "https://your-bookstack.com",
        "BOOKSTACK_TOKEN_ID": "your-token-id",
        "BOOKSTACK_TOKEN_SECRET": "your-token-secret"
      }
    }
  }
}

LibreChat (stdio, シングルユーザー)

librechat.yaml に追加します：

mcpServers:
  bookstack:
    command: npx
    args:
      - -y
      - bookstack-mcp
    env:
      BOOKSTACK_BASE_URL: "https://your-bookstack.com"
      BOOKSTACK_TOKEN_ID: "your-token-id"
      BOOKSTACK_TOKEN_SECRET: "your-token-secret"

LibreChat (Streamable HTTP, 本番環境/Docker 推奨)

サーバーを常駐 HTTP サービスとして実行し、LibreChat からその URL を指定します。これはマルチユーザー環境やコンテナ化されたデプロイメントに適した設定です。

サーバーを HTTP モードで起動します：

MCP_TRANSPORT=http \
MCP_HTTP_PORT=8080 \
BOOKSTACK_BASE_URL=https://your-bookstack.com \
BOOKSTACK_TOKEN_ID=your-token-id \
BOOKSTACK_TOKEN_SECRET=your-token-secret \
npx bookstack-mcp

次に LibreChat を設定します：

mcpServers:
  bookstack:
    type: streamable-http
    url: http://bookstack-mcp:8080/mcp

3.0.0 での破壊的変更: 非推奨となっていた HTTP+SSE トランスポート (GET /sse + POST /messages) が削除されました。/mcp での Streamable HTTP はすでにストリーミングレスポンスのために SSE を使用しており、現在の MCP クライアントにおける唯一の HTTP トランスポートです。レガシーエンドポイントを必要とする古いクライアントを使用している場合は、bookstack-mcp@2.x に固定してください。

HTTP トランスポート環境変数

0.0.0.0 にバインドする場合（他のサービスから到達可能なコンテナ内など）、MCP_HTTP_ALLOWED_HOSTS に LibreChat がこのサーバーに到達するために使用するホスト名を設定してください（例: MCP_HTTP_ALLOWED_HOSTS=bookstack-mcp,bookstack-mcp.internal）。

設定変更後は LibreChat を再起動してください。

Claude Code (CLI)

推奨される方法は、このリポジトリのプラグインマニフェスト (.claude-plugin/plugin.json) を提供する ttpears/claude-plugins マーケットプレイスを使用することです：

/plugin marketplace add ttpears/claude-plugins
/plugin install bookstack-mcp@ttpears-plugins

次に、プラグインの MCP サーバーが認証できるように、シェルで BOOKSTACK_* 環境変数を設定します：

export BOOKSTACK_BASE_URL=https://your-bookstack.com
export BOOKSTACK_TOKEN_ID=your-token-id
export BOOKSTACK_TOKEN_SECRET=your-token-secret

手動インストール（代替手段）

マーケットプレイスを使用したくない場合は、claude mcp add で直接サーバーを登録します。各変数に対して --env を繰り返し、すべてのフラグをサーバー名の前に置き、-- を使用して Claude Code が起動するコマンドの開始位置を指定します：

claude mcp add bookstack \
  --transport stdio \
  --scope user \
  --env BOOKSTACK_BASE_URL=https://your-bookstack.com \
  --env BOOKSTACK_TOKEN_ID=your-token-id \
  --env BOOKSTACK_TOKEN_SECRET=your-token-secret \
  -- npx -y bookstack-mcp

スコープはエントリの書き込み先を選択します：

結果として生成される設定エントリは以下のようになります（プロジェクトスコープの場合は .mcp.json、それ以外は ~/.claude.json）：

{
  "mcpServers": {
    "bookstack": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "bookstack-mcp"],
      "env": {
        "BOOKSTACK_BASE_URL": "https://your-bookstack.com",
        "BOOKSTACK_TOKEN_ID": "your-token-id",
        "BOOKSTACK_TOKEN_SECRET": "your-token-secret"
      }
    }
  }
}

コミットする .mcp.json のヒント: Claude Code は .mcp.json 内の ${VAR} および ${VAR:-default} 参照をシェル環境から展開します。これを利用してシークレットを git に含めないようにします：ファイル内に "BOOKSTACK_TOKEN_SECRET": "${BOOKSTACK_TOKEN_SECRET}" を設定し、各開発者がシェルで変数をエクスポートするようにします。

MCP リソース

本やページは MCP リソースとしても公開されているため、リソースをブラウズできるクライアント（Claude Desktop、MCP Inspector など）では @ メンションで直接参照できます：

どちらのテンプレートも id のオートコンプリートをサポートしています。入力中にサーバーが BookStack を検索し、一致する ID を返すため、数値 ID を手動で覚える必要はありません。

利用可能なツール

読み取り操作（常に利用可能）

書き込み操作 (BOOKSTACK_ENABLE_WRITE=true が必要)

BookStack API のセットアップ

1. 管理者として BookStack にログイン

2. 設定 > ユーザー > ユーザーの編集 に移動

3. ユーザーに システム API へのアクセス 権限があることを確認

4. API トークン セクションで新しいトークンを作成

5. トークン ID とトークンシークレットをコピー

セキュリティ

• 書き込み操作は デフォルトで無効 です

• 本番環境では HTTPS を使用してください

• API トークンは安全に保管してください（git にコミットしないでください）

• 権限を制限した専用の BookStack ユーザーの使用を検討してください

開発

npm run dev          # Hot reload with tsx
npm run type-check   # Type checking only
npm run build        # Production build

ライセンス

MIT