calibre-mcp — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер для связи ИИ-ассистентов с электронной библиотекой Calibre. Ищет фрагменты по смыслу, отдаёт текст глав и правит метаданные.
claude mcp add --env CALIBRE_MCP_SERVER_URL=<CALIBRE_MCP_SERVER_URL> --env CALIBRE_MCP_LIBRARY=<CALIBRE_MCP_LIBRARY> --env CALIBRE_MCP_ENABLE_WRITE=<CALIBRE_MCP_ENABLE_WRITE> --env CALIBRE_MCP_CALIBREDB_PATH=<CALIBRE_MCP_CALIBREDB_PATH> --transport stdio calibre-mcp -- npx -y calibre-mcpЧто делает calibre-mcp
Сервер добавляет 19 инструментов для работы с Calibre. Ассистент находит нужные книги через гибридный векторный и ключевой поиск. Можно искать сразу по всей коллекции или углубиться внутрь одного тома, чтобы получить точный отрывок. Поиск понимает запросы на русском и английском языках.
По умолчанию сервер работает только на чтение. Для изменения метаданных или слияния дубликатов запись включают отдельно переменной окружения. Все запросы на запись идут через Content Server, поэтому база не конфликтует с запущенным приложением Calibre на рабочем столе.
Для запуска нужен Node.js версии не ниже 22.16 и включённый Content Server в настройках Calibre. Без системных утилит pdftotext или библиотеки pymupdf сервер читает файлы PDF через штатный ebook-convert.
Какие задачи решает
- найти нужный фрагмент в книгах по смысловому описанию темы
- прочитать главу или получить иллюстрацию прямо в диалоге
- выявить дубликаты в каталоге с проверкой безопасности объединения
- восстановить метаданные книги по названию файла через Google Books
Примеры запросов агенту
- Найди в библиотеке книги, где объясняется ребалансировка consumer-групп
- Покажи главу про индексы из книги по базам данных
- Проверь каталог на дубликаты перед объединением записей
Как установить calibre-mcp
Командой платформы
claude mcp add --env CALIBRE_MCP_SERVER_URL=<CALIBRE_MCP_SERVER_URL> --env CALIBRE_MCP_LIBRARY=<CALIBRE_MCP_LIBRARY> --env CALIBRE_MCP_ENABLE_WRITE=<CALIBRE_MCP_ENABLE_WRITE> --env CALIBRE_MCP_CALIBREDB_PATH=<CALIBRE_MCP_CALIBREDB_PATH> --transport stdio calibre-mcp -- npx -y calibre-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add calibre-mcp --env CALIBRE_MCP_SERVER_URL=<CALIBRE_MCP_SERVER_URL> --env CALIBRE_MCP_LIBRARY=<CALIBRE_MCP_LIBRARY> --env CALIBRE_MCP_ENABLE_WRITE=<CALIBRE_MCP_ENABLE_WRITE> --env CALIBRE_MCP_CALIBREDB_PATH=<CALIBRE_MCP_CALIBREDB_PATH> -- npx -y calibre-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"calibre-mcp": {
"command": "npx",
"args": [
"-y",
"calibre-mcp"
],
"env": {
"CALIBRE_MCP_SERVER_URL": "<CALIBRE_MCP_SERVER_URL>",
"CALIBRE_MCP_LIBRARY": "<CALIBRE_MCP_LIBRARY>",
"CALIBRE_MCP_ENABLE_WRITE": "<CALIBRE_MCP_ENABLE_WRITE>",
"CALIBRE_MCP_CALIBREDB_PATH": "<CALIBRE_MCP_CALIBREDB_PATH>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"calibre-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"calibre-mcp"
],
"env": {
"CALIBRE_MCP_SERVER_URL": "<CALIBRE_MCP_SERVER_URL>",
"CALIBRE_MCP_LIBRARY": "<CALIBRE_MCP_LIBRARY>",
"CALIBRE_MCP_ENABLE_WRITE": "<CALIBRE_MCP_ENABLE_WRITE>",
"CALIBRE_MCP_CALIBREDB_PATH": "<CALIBRE_MCP_CALIBREDB_PATH>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e CALIBRE_MCP_SERVER_URL=<CALIBRE_MCP_SERVER_URL> -e CALIBRE_MCP_LIBRARY=<CALIBRE_MCP_LIBRARY> -e CALIBRE_MCP_ENABLE_WRITE=<CALIBRE_MCP_ENABLE_WRITE> -e CALIBRE_MCP_CALIBREDB_PATH=<CALIBRE_MCP_CALIBREDB_PATH> calibre-mcp npx -y calibre-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о calibre-mcp
Что делает calibre-mcp?
Сервер подключает языковую модель к локальной библиотеке Calibre по протоколу MCP. Доступно 19 инструментов для семантического поиска по книгам, чтения глав, анализа дубликатов и редактирования метаданных.
Как установить calibre-mcp в Claude Code?
Запустите команду claude mcp add calibre-mcp -- npx -y calibre-mcp. Для настройки путей или включения записи передайте переменные через флаги --env CALIBRE_MCP_SERVER_URL и --env CALIBRE_MCP_ENABLE_WRITE.
Что нужно настроить перед первым запуском?
В Calibre требуется запустить Content Server через меню «Соединить/общий доступ». Также на компьютере должен быть установлен Node.js версии 22.16 или новее.
