calibre-mcp

Ein Model Context Protocol (MCP) Server zum Suchen, Lesen und Verwalten Ihrer Calibre-E-Book-Bibliothek. Komplett in TypeScript für Bun neu geschrieben, bietet er ultraschnelle Leistung, tiefe Integration mit Calibres CLI-Tools und automatisierte Inhaltsextraktion.

🚀 Funktionen

• Blitzschnelle Metadatensuche: Fragt die Calibre metadata.db direkt über SQLite ab, für nahezu sofortige Ergebnisse.

• Volltextsuche: Nutzt Calibres indizierte Volltext-Suchmaschine, um spezifische Phrasen in Ihrer gesamten Bibliothek zu finden.

• Dynamische Inhaltsextraktion: Konvertiert EPUB, PDF und andere Formate automatisch und direkt während der Nutzung in Text. Keine manuellen .txt-Exporte erforderlich.

• Umfassende Bibliotheksverwaltung: Aktualisieren Sie Datenbank-Metadaten, ändern Sie interne Datei-Metadaten, optimieren Sie Bücher und konvertieren Sie zwischen Formaten.

• Intelligente Ergebnisverteilung: Suchergebnisse werden intelligent über verschiedene Bücher verteilt, um vielfältige Treffer zu liefern.

• Benutzerdefiniertes URL-Schema: Verwendet epub://-URLs für die präzise Referenzierung von Buchstandorten und Zeilenbereichen.

Related MCP server: Calibre RAG MCP Server

📋 Voraussetzungen

• Calibre installiert unter /Applications/calibre.app (macOS).

• Bun Laufzeitumgebung installiert.

• Eine Calibre-Bibliothek.

⚙️ Konfiguration

Der Server verwendet die folgenden Umgebungsvariablen:

• CALIBRE_LIBRARY_PATH: Pfad zu Ihrer Calibre-Bibliothek (wo sich metadata.db befindet). Standardmäßig /Volumes/Xarismata/eBooks/CalibreNuevo.

🛠 Installation

1. Klonen Sie dieses Repository:

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

2. Installieren Sie die Abhängigkeiten:

bun install

⌨️ Verwendung

Mit MCP Inspector

Testen Sie den Server in einer interaktiven Umgebung:

npx @modelcontextprotocol/inspector bun src/index.ts

Mit Claude Desktop

Fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu:

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

🧰 Verfügbare Tools

Tool-Details & Beispiele

search_library

Suchen Sie mit natürlicher Sprache nach Inhalten oder spezifischen Feldern für Metadaten.

• Abfragebeispiele:

  • "machine learning" (Volltextsuche)

  • author:Asimov title:Foundation (Metadatensuche)

  • tag:science-fiction rating:>4 (Erweiterte Filterung)

read_content

Verwendet das epub://-Schema.

• Format: epub://[author]/[title]@[book_id]#[start_line]:[end_line]

• Beispiel: epub://Isaac%20Asimov/Foundation@123#500:600 ruft die Zeilen 500 bis 600 ab.

polish_book

Perfekt zum Bereinigen automatisierter Konvertierungen oder alter Dateien.

• Optionen: smartenPunctuation, compressImages, upgradeBook, removeUnusedCss.

convert_ebook

Konvertieren Sie Formate und aktualisieren Sie automatisch Ihren Bibliothekseintrag.

• Beispiel: book_id: 45, output_format: "azw3", options: ["--enable-heuristics"]

deep_search_book

Suchen Sie direkt innerhalb eines bestimmten Buches (nützlich, falls Calibre FTS es noch nicht indiziert hat).

• Beispiel: book_id: 123, query: "quantum entanglement", context_lines: 3

⚖️ Lizenz

Apache License 2.0 - Siehe LICENSE-Datei für Details.