BookStack MCP Server

MCP-сервер для вики BookStack: поиск и чтение по умолчанию, запись включается отдельно, права берутся из токена.

  • 55 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Читает вики BookStack и, при включенной записи, создает и меняет страницы по токену API.
  • Токен и секрет хранятся в переменных окружения клиента.
Все причины и проверки

ttpears/bookstack-mcp

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/bookstack-mcp-server

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Читает вики BookStack и, при включенной записи, создает и меняет страницы по токену API.
  • Токен и секрет хранятся в переменных окружения клиента.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

BookStack MCP Server подключает ИИ-помощника к вики BookStack через Model Context Protocol: поиск документации, ответы на вопросы по ней и работа со страницами. По умолчанию сервер только читает: 21 инструмент чтения, а при включении появляются 22 инструмента записи. Права BookStack действуют на каждый запрос к API, поэтому для сервера заводят отдельного пользователя. Чтобы читать страницы редактора WYSIWYG как Markdown, токену нужно право Export Content. Установка идет пакетом `.mcpb` для Claude Desktop, плагином для Claude Code, Codex, Cursor и Gemini CLI либо записью `npx -y bookstack-mcp` в конфигурации. Есть вариант внутреннего HTTP-сервиса и удаленного коннектора со входом Microsoft Entra.

Для кого. Командам, которые держат документацию в BookStack и хотят, чтобы агент искал в ней ответы и аккуратно дополнял страницы.

Подходит, если

  • Агент отвечает на вопрос по внутренней документации со ссылкой на страницу.
  • Нужно найти нужную книгу и главу и прочитать страницу целиком в Markdown.
  • Агент должен дописать страницу после прохождения проверки прав.
  • Общий сервер нужен нескольким клиентам LibreChat внутри сети.

Не подходит, если

  • Вики приватная, а API-токена для отдельного пользователя нет.
  • Нужно разрешить агенту любые изменения без подтверждения.
  • Нужна совместная работа без сервера BookStack.

Пример запроса к агенту

Найди в BookStack инструкцию по развертыванию, прочитай страницу в Markdown и перечисли связанные страницы.

MCP

Транспорт
stdio, http
Авторизация
API-ключ

Переменные окружения

BOOKSTACK_BASE_URL обязательная
Адрес вики BookStack.
BOOKSTACK_TOKEN_ID обязательная, секрет
Идентификатор токена API BookStack.
BOOKSTACK_TOKEN_SECRET обязательная, секрет
Секрет токена API BookStack.
BOOKSTACK_ENABLE_WRITE
`true` открывает инструменты записи.

Ограничения

Нужны токен API BookStack (идентификатор и секрет) пользователя с правом Access System API и права на просмотр нужных книг и страниц. Запись выключена по умолчанию, режим `BOOKSTACK_ENABLE_WRITE=true` открывает 22 инструмента изменения, а в режиме OAuth запись определяют права входа. Опубликованный пакет объявляет `node >=18`, но рекомендуется Node 24 либо 22. Для общего сервера задайте внутренний HTTP или вход Microsoft Entra.

Как отключить. Удалите запись `bookstack` из настроек клиента, снимите плагин или расширение `.mcpb`, а токен API отзовите в профиле BookStack. Выделенного пользователя можно удалить.

Частые вопросы

Какие переменные нужны?

`BOOKSTACK_BASE_URL`, `BOOKSTACK_TOKEN_ID` и `BOOKSTACK_TOKEN_SECRET`. Для записи добавьте `BOOKSTACK_ENABLE_WRITE=true`.

Как поставить в Claude Desktop?

Скачайте `.mcpb` из последнего релиза, откройте Settings, Extensions и введите три значения BookStack.

Сколько инструментов?

21 инструмент чтения и 22 инструмента записи, если запись включена.

Почему не читается Markdown у страниц?

Редактор WYSIWYG хранит страницы без Markdown-источника, и сервер читает их через экспорт. Токену нужно право Export Content.

Можно ли держать общий сервер?

Да: внутренний HTTP-сервис для LibreChat или удаленный коннектор по HTTPS со входом Microsoft Entra.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы
Официальный

Официальный MCP-сервер Kibela ищет, читает и правит заметки, папки и комментарии вашей вики прямо из чата с ассистентом

MCP-серверРасширенный доступ16Звезды репозитория

Локальная читальня для Claude: книга EPUB или TXT режется на фрагменты, а заметки на полях и прогресс сохраняются между сессиями.

MCP-серверРасширенный доступ120Звезды репозитория

MCP-сервер для Apple Books на macOS: агент видит текущую книгу, читает главы, выделения и заметки, ищет книги

MCP-серверРасширенный доступ64Звезды репозитория

Подключает агента к Nextcloud: заметки, календарь, контакты, файлы, почта и доски Deck через 110 с лишним инструментов MCP

MCP-серверШирокий доступ411Звезды репозитория
Официальный

MCP-сервер к базе знаний, которую Beever Atlas строит из чатов Slack, Discord, Teams и Mattermost: ответы с цитатами, вики по каналам, граф связей

MCP-серверШирокий доступ454Звезды репозитория

MCP-сервер для WeChat Reading: ИИ-агент получает вашу книжную полку, заметки, подчеркивания и популярные отзывы

MCP-серверШирокий доступ584Звезды репозитория

Коротко о README

Сервер не вводит собственных прав: действует модель доступа BookStack. Для разных клиентов есть нативные плагины и пакет для Claude Desktop.

Бейдж для README

Сообщить о проблеме