calibre-mcp

Un servidor de Model Context Protocol (MCP) para buscar, leer y gestionar tu biblioteca de libros electrónicos de Calibre. Completamente reescrito en TypeScript para Bun, ofrece un rendimiento ultrarrápido, una integración profunda con las herramientas CLI de Calibre y extracción automatizada de contenido.

🚀 Características

• Búsqueda de metadatos increíblemente rápida: Consulta el archivo metadata.db de Calibre directamente a través de SQLite para obtener resultados casi instantáneos.

• Búsqueda de contenido de texto completo: Aprovecha el motor de búsqueda de texto completo indexado de Calibre para encontrar frases específicas en toda tu biblioteca.

• Extracción dinámica de contenido: Convierte automáticamente EPUB, PDF y otros formatos a texto sobre la marcha. No se requieren exportaciones manuales a .txt.

• Gestión integral de la biblioteca: Actualiza los metadatos de la base de datos, modifica los metadatos internos de los archivos, perfecciona libros y convierte entre formatos.

• Distribución inteligente de resultados: Los resultados de búsqueda se equilibran de forma inteligente entre diferentes libros para proporcionar coincidencias diversas.

• Esquema de URL personalizado: Utiliza URLs epub:// para una referencia precisa de las ubicaciones de los libros y los rangos de líneas.

Related MCP server: Calibre RAG MCP Server

📋 Requisitos previos

• Calibre instalado en /Applications/calibre.app (macOS).

• Entorno de ejecución Bun instalado.

• Una biblioteca de Calibre.

⚙️ Configuración

El servidor utiliza las siguientes variables de entorno:

• CALIBRE_LIBRARY_PATH: Ruta a tu biblioteca de Calibre (donde reside metadata.db). El valor predeterminado es /Volumes/Xarismata/eBooks/CalibreNuevo.

🛠 Instalación

1. Clona este repositorio:

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

2. Instala las dependencias:

bun install

⌨️ Uso

Con MCP Inspector

Prueba el servidor en un entorno interactivo:

npx @modelcontextprotocol/inspector bun src/index.ts

Con Claude Desktop

Añade lo siguiente a tu claude_desktop_config.json:

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

🧰 Herramientas disponibles

Detalles y ejemplos de herramientas

search_library

Busca usando lenguaje natural para contenido o campos específicos para metadatos.

• Ejemplos de consulta:

  • "machine learning" (Búsqueda de texto completo)

  • author:Asimov title:Foundation (Búsqueda de metadatos)

  • tag:science-fiction rating:>4 (Filtrado avanzado)

read_content

Utiliza el esquema epub://.

• Formato: epub://[autor]/[título]@[id_libro]#[línea_inicio]:[línea_fin]

• Ejemplo: epub://Isaac%20Asimov/Foundation@123#500:600 recupera las líneas 500 a 600.

polish_book

Perfecto para limpiar conversiones automatizadas o archivos antiguos.

• Opciones: smartenPunctuation, compressImages, upgradeBook, removeUnusedCss.

convert_ebook

Convierte formatos y actualiza automáticamente el registro de tu biblioteca.

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

deep_search_book

Busca directamente dentro de un libro específico (útil si el FTS de Calibre aún no lo ha indexado).

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

⚖️ Licencia

Licencia Apache 2.0 - Consulta el archivo LICENSE para más detalles.