calibre-mcp

Ein MCP-Server, der KI-Assistenten (Claude Code, Claude Desktop, Cursor, ...) Lese- und Schreibzugriff auf Ihre lokale Calibre-E-Book-Bibliothek gewährt.

Durchsuchen Sie die Bibliothek, blättern Sie durch neue Einträge, importieren Sie neue E-Books mit automatischer Duplikaterkennung und verwalten Sie einen „Drop-Ordner“-Posteingang – alles per Chat.

• Null-Konfiguration bei normaler Einrichtung: Das calibredb-Programm und die Bibliothek, die Ihre Calibre-GUI verwendet, werden automatisch auf macOS, Windows und Linux erkannt.

• Gebietsschema-unabhängig: Alle Lesevorgänge laufen über calibredb --for-machine (JSON), sodass Ergebnisse nie von der Sprache Ihrer Calibre-Oberfläche abhängen.

• Standardmäßig sicher: Die Duplikaterkennung verlässt sich auf Calibre selbst – ein Buch, dessen Titel + Autor bereits in der Bibliothek ist, wird übersprungen und nie doppelt importiert.

Tools

Related MCP server: Calibre MCP Server

Voraussetzungen

• Calibre (jede Version, die calibredb enthält; getestet mit 9.x)

• Python ≥ 3.10

Installation

pipx (empfohlen)

pipx install calibre-mcp

uv

uv tool install calibre-mcp

pip

pip install calibre-mcp

Aus dem Quellcode

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

Konfiguration

Bei einer normalen Einrichtung ist alles optional; jeder Wert kann mit einer Umgebungsvariable festgelegt werden.

Registrierung bei Claude Code

claude mcp add calibre-mcp -- calibre-mcp

oder zu ~/.claude.json → mcpServers (Benutzerbereich) hinzufügen:

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

Registrierung bei Claude Desktop / Cursor

Fügen Sie denselben JSON-Block zum MCP-Server-Abschnitt von claude_desktop_config.json (Claude Desktop) oder zu den MCP-Einstellungen von Cursor hinzu.

Posteingangs-Workflow

Ein Drop-Ordner ergibt einen angenehmen „Finden → Ablegen → Archivieren“-Kreislauf für Bücher, die Sie von Hand herunterladen:

1. Richten Sie CALIBRE_INBOX_DIR auf einen Ordner, z. B. ~/Downloads/Calibre-Inbox.

2. Laden Sie E-Books in diesen Ordner herunter.

3. Bitten Sie Ihren Assistenten, import_inbox auszuführen.

Jede Datei wird zur Bibliothek hinzugefügt; erfolgreich hinzugefügte Dateien und Duplikate werden unter imported/YYYY-MM/ abgelegt, Fehlschläge unter failed/ – der Posteingang selbst bleibt sauber, und nichts wird jemals überschrieben (Namenskollisionen erhalten ein Suffix -1, -2, ...).

Unterstützte Erweiterungen: .epub .pdf .mobi .azw .azw3 .djvu .cbz .cbr .fb2 .txt .md .docx .rtf .lit .prc .pdb .chm .htmlz.

Einschränkungen

• Datenbanksperre: Während die Calibre-GUI die Bibliothek geöffnet hat, können Schreibvorgänge (add_books, import_inbox) mit einem Datenbanksperrfehler fehlschlagen. Schreibgeschützte Tools funktionieren weiterhin. Schließen Sie Calibre (oder wechseln Sie zu einer anderen Bibliothek), bevor Sie importieren.

• Große Bibliotheken: add_books/import_inbox erstellen bei jedem Hinzufügen eine Momentaufnahme der vollständigen Menge an Buch-IDs, was in der Praxis schnell ist, aber O(Anzahl der Bücher) pro Import beträgt.

• Dieses Tool organisiert nur Ihre Bibliothek. Es enthält keine Such- oder Download-Funktionalität; verwenden Sie es mit Inhalten, die Sie rechtmäßig besitzen dürfen.

Entwicklung

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

Integrationstests erstellen Wegwerf-Bibliotheken unter /tmp und berühren nie Ihre echte Bibliothek.

Lizenz

MIT – siehe LICENSE.

Kurzübersicht

Ein MCP-Server, der Ihre lokale Calibre-Bibliothek mit KI-Assistenten wie Claude/Cursor verbindet: fünf Tools (library_info / search_books / list_books / add_books / import_inbox), automatische Erkennung von calibredb und Bibliotheksspeicherort, sofort einsatzbereit auf allen Plattformen (Windows/macOS/Linux).

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

Automatische Duplikaterkennung beim Import (Bücher mit gleichem Titel + Autor werden nicht doppelt importiert); mit dem CALIBRE_INBOX_DIR-Posteingangsordner können Sie heruntergeladene Bücher hineinlegen und „Posteingang importieren“ sagen, um sie zu archivieren; verarbeitete Dateien werden automatisch unter imported/ oder failed/ einsortiert.

Hinweis: Wenn die Calibre-Desktop-Anwendung dieselbe Bibliothek geöffnet hat, können Schreibvorgänge aufgrund der Datenbanksperre fehlschlagen. Schließen Sie Calibre vor dem Import.