calibre-mcp

MCP-сервер, который даёт ИИ-ассистентам (Claude Code, Claude Desktop, Cursor, ...) доступ на чтение и запись к вашей локальной библиотеке электронных книг Calibre.

Ищите по библиотеке, просматривайте недавние добавления, импортируйте новые электронные книги с автоматическим обнаружением дубликатов и управляйте входящей папкой («drop folder») — всё прямо из чата.

• Нулевая настройка в типичной конфигурации: исполняемый файл calibredb и библиотека, которую использует ваш GUI Calibre, обнаруживаются автоматически на macOS, Windows и Linux.

• Не зависит от локали: все операции чтения выполняются через calibredb --for-machine (JSON), поэтому результаты никогда не зависят от языка интерфейса Calibre.

• Безопасно по умолчанию: обнаружение дубликатов опирается на сам Calibre — книга, чьи название + автор уже есть в библиотеке, пропускается и никогда не импортируется дважды.

Инструменты

Related MCP server: Calibre MCP Server

Требования

• Calibre (любая версия, в состав которой входит calibredb; протестировано с 9.x)

• Python ≥ 3.10

Установка

pipx (рекомендуется)

pipx install calibre-mcp

uv

uv tool install calibre-mcp

pip

pip install calibre-mcp

Из исходников

git clone https://github.com/ZehuiTIAN/calibre-mcp.git
cd calibre-mcp
pip install -e ".[dev]"     # dev extras add pytest + ruff

Конфигурация

Всё опционально в типичной конфигурации; каждое значение можно зафиксировать с помощью переменной окружения.

Регистрация в Claude Code

claude mcp add calibre-mcp -- calibre-mcp

или добавьте в ~/.claude.json → mcpServers (на уровне пользователя):

"calibre_mcp": {
  "type": "stdio",
  "command": "calibre-mcp",
  "args": [],
  "env": {
    "CALIBRE_LIBRARY_PATH": "/path/to/your/library",
    "CALIBRE_INBOX_DIR": "/path/to/your/inbox"
  }
}

Регистрация в Claude Desktop / Cursor

Добавьте тот же JSON-блок в секцию MCP-серверов файла claude_desktop_config.json (Claude Desktop) или в настройки MCP в Cursor.

Работа с входящей папкой

Входящая папка создаёт удобный цикл «найти → положить → архивировать» для книг, которые вы скачиваете вручную:

1. Укажите CALIBRE_INBOX_DIR на папку, например ~/Downloads/Calibre-Inbox.

2. Скачивайте электронные книги в эту папку.

3. Попросите ассистента выполнить import_inbox.

Каждый файл добавляется в библиотеку; успешно добавленные файлы и дубликаты раскладываются в imported/YYYY-MM/, неудачные — в failed/. Сама входящая папка остаётся чистой, и ничто никогда не перезаписывается (при совпадении имён добавляется суффикс -1, -2, ...).

Поддерживаемые расширения: .epub .pdf .mobi .azw .azw3 .djvu .cbz .cbr .fb2 .txt .md .docx .rtf .lit .prc .pdb .chm .htmlz.

Предостережения

• Блокировка базы данных: пока GUI Calibre держит библиотеку открытой, операции записи (add_books, import_inbox) могут завершиться ошибкой блокировки базы данных. Инструменты только для чтения продолжают работать. Закройте Calibre (или переключите его на другую библиотеку) перед импортом.

• Большие библиотеки: add_books/import_inbox при каждом добавлении создают снимок полного набора идентификаторов книг — на практике это быстро, но составляет O(количество книг) на один импорт.

• Этот инструмент лишь организует вашу библиотеку. В нём нет функций поиска или скачивания; используйте его с контентом, право на хранение которого у вас есть.

Разработка

pip install -e ".[dev]"
ruff check .
pytest -m "not integration"      # unit tests, run anywhere
pytest                           # + integration tests (need local calibre)

Интеграционные тесты создают временные библиотеки в /tmp и никогда не касаются вашей настоящей библиотеки.

Лицензия

MIT — см. LICENSE.

Краткий обзор на китайском

MCP-сервер, подключающий локальную библиотеку Calibre к ИИ-ассистентам (Claude/Cursor и др.): пять инструментов (library_info / search_books / list_books / add_books / import_inbox), автоматическое обнаружение calibredb и расположения библиотеки, готов к работе из коробки на всех платформах (Windows/macOS/Linux).

pipx install calibre-mcp
claude mcp add calibre-mcp -- calibre-mcp

При импорте автоматически выполняется проверка дубликатов (книга с тем же названием и автором не будет импортирована повторно); в сочетании с каталогом входящих CALIBRE_INBOX_DIR достаточно положить скачанные книги в папку и сказать «импортировать входящие», и они будут архивированы. Обработанные файлы автоматически раскладываются в imported/ или failed/.

Примечание: когда настольная программа Calibre держит ту же библиотеку открытой, операции записи могут завершиться ошибкой из-за блокировки базы данных; перед импортом закройте Calibre.