# calibre-mcp

MCP-сервер для связи ИИ-ассистентов с электронной библиотекой Calibre. Ищет фрагменты по смыслу, отдаёт текст глав и правит метаданные.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 20
- Автор: caelum29
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/caelum29/calibre-mcp
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/mcp/calibre-mcp

## Что делает

Сервер добавляет 19 инструментов для работы с Calibre. Ассистент находит нужные книги через гибридный векторный и ключевой поиск. Можно искать сразу по всей коллекции или углубиться внутрь одного тома, чтобы получить точный отрывок. Поиск понимает запросы на русском и английском языках.

По умолчанию сервер работает только на чтение. Для изменения метаданных или слияния дубликатов запись включают отдельно переменной окружения. Все запросы на запись идут через Content Server, поэтому база не конфликтует с запущенным приложением Calibre на рабочем столе.

Для запуска нужен Node.js версии не ниже 22.16 и включённый Content Server в настройках Calibre. Без системных утилит `pdftotext` или библиотеки `pymupdf` сервер читает файлы PDF через штатный `ebook-convert`.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `CALIBRE_MCP_SERVER_URL`, `CALIBRE_MCP_LIBRARY`, `CALIBRE_MCP_ENABLE_WRITE`, `CALIBRE_MCP_CALIBREDB_PATH` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

## Когда брать
- найти нужный фрагмент в книгах по смысловому описанию темы
- прочитать главу или получить иллюстрацию прямо в диалоге
- выявить дубликаты в каталоге с проверкой безопасности объединения
- восстановить метаданные книги по названию файла через Google Books

## Примеры запросов агенту
- Найди в библиотеке книги, где объясняется ребалансировка consumer-групп
- Покажи главу про индексы из книги по базам данных
- Проверь каталог на дубликаты перед объединением записей

## Похожие
- [Reactive Resume](https://affpapa.org/nevibecode/mcp/reactive-resume.md) — MCP-сервер · ★ 44874
- [screenpipe](https://affpapa.org/nevibecode/mcp/screenpipe.md) — MCP-сервер · ★ 22053
- [Inbox Zero](https://affpapa.org/nevibecode/mcp/inbox-zero.md) — MCP-сервер · ★ 12791
- [kaneo](https://affpapa.org/nevibecode/mcp/kaneo.md) — MCP-сервер · ★ 9602
- [Mindwtr](https://affpapa.org/nevibecode/mcp/mindwtr.md) — MCP-сервер · ★ 2318
- [Azure DevOps (ADO)](https://affpapa.org/nevibecode/mcp/azure-devops-ado.md) — MCP-сервер · ★ 2067

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md