calibre-mcp

Сервер протокола контекста модели (MCP) для поиска, чтения и управления вашей библиотекой электронных книг Calibre. Полностью переписан на TypeScript для Bun, предлагает сверхвысокую производительность, глубокую интеграцию с инструментами командной строки Calibre и автоматическое извлечение контента.

🚀 Функции

• Молниеносный поиск по метаданным: Запросы к metadata.db Calibre напрямую через SQLite для получения результатов практически мгновенно.

• Полнотекстовый поиск: Использует индексированный полнотекстовый поисковый движок Calibre для поиска конкретных фраз по всей вашей библиотеке.

• Динамическое извлечение контента: Автоматически преобразует EPUB, PDF и другие форматы в текст «на лету». Ручной экспорт в .txt не требуется.

• Комплексное управление библиотекой: Обновление метаданных базы данных, изменение внутренних метаданных файлов, улучшение книг и конвертация между форматами.

• Умное распределение результатов: Результаты поиска интеллектуально распределяются по разным книгам для обеспечения разнообразных совпадений.

• Пользовательская схема URL: Использует URL-адреса epub:// для точного указания местоположения книг и диапазонов строк.

Related MCP server: Calibre RAG MCP Server

📋 Предварительные требования

• Calibre, установленный в /Applications/calibre.app (macOS).

• Установленная среда выполнения Bun.

• Библиотека Calibre.

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

Сервер использует следующие переменные окружения:

• CALIBRE_LIBRARY_PATH: Путь к вашей библиотеке Calibre (где находится metadata.db). По умолчанию: /Volumes/Xarismata/eBooks/CalibreNuevo.

🛠 Установка

1. Клонируйте этот репозиторий:

git clone https://github.com/2b3pro/calibre-mcp.git
cd calibre-mcp

2. Установите зависимости:

bun install

⌨️ Использование

С помощью MCP Inspector

Протестируйте сервер в интерактивной среде:

npx @modelcontextprotocol/inspector bun src/index.ts

С помощью Claude Desktop

Добавьте следующее в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "calibre": {
      "command": "bun",
      "args": ["run", "/absolute/path/to/calibre-mcp/src/index.ts"]
    }
  }
}

🧰 Доступные инструменты

Подробности об инструментах и примеры

search_library

Поиск с использованием естественного языка для контента или конкретных полей для метаданных.

• Примеры запросов:

  • "machine learning" (Полнотекстовый поиск)

  • author:Asimov title:Foundation (Поиск по метаданным)

  • tag:science-fiction rating:>4 (Расширенная фильтрация)

read_content

Использует схему epub://.

• Формат: epub://[автор]/[название]@[id_книги]#[начальная_строка]:[конечная_строка]

• Пример: epub://Isaac%20Asimov/Foundation@123#500:600 извлекает строки с 500 по 600.

polish_book

Идеально подходит для очистки после автоматических конвертаций или старых файлов.

• Опции: smartenPunctuation, compressImages, upgradeBook, removeUnusedCss.

convert_ebook

Конвертируйте форматы и автоматически обновляйте запись в вашей библиотеке.

• Пример: book_id: 45, output_format: "azw3", options: ["--enable-heuristics"]

deep_search_book

Поиск непосредственно внутри конкретной книги (полезно, если Calibre FTS еще не проиндексировал её).

• Пример: book_id: 123, query: "quantum entanglement", context_lines: 3

⚖️ Лицензия

Apache License 2.0 - Подробности см. в файле LICENSE.