ptbsare/anx-calibre-manager
ptbsare/anx-calibre-manager has 203 GitHub stars and 20 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-19 04:12 UTC. Last push 2026-11-13.
What you can do
- Multi-language Support: Full internationalization support. The interface is available in English, Simplified Chinese (简体中文), Traditional Chinese (繁體中文), Spanish, French, and German.
- Mobile-First Interface: A clean, responsive UI designed for easy use on your phone.
- PWA Support: Installable as a Progressive Web App for a native-like experience.
- In-Browser Book Previewer: Preview E-Book directly in your browser. Features Text-to-Speech (TTS).
Crecimiento de estrellas medido
- in 24h
- 0
- in 7 days
- Recopilando historial
- in 15 days
- Recopilando historial
- in 1 month
- Recopilando historial
Cambios netos en períodos que se solapan, no totales diarios. Los datos no disponibles se dejan en blanco. Las estrellas indican interés, no calidad.
Acerca de
A modern, mobile-first web application to manage your ebook library, integrating with Calibre and providing a personal WebDAV server for your Anx-reader compatible devices.
Web y aplicacionesREADME_es.md
OriginalAnx Calibre Manager
Una aplicación web moderna y orientada a dispositivos móviles para gestionar tu biblioteca de libros electrónicos, que se integra con Calibre y proporciona un servidor WebDAV personal para tus dispositivos compatibles con Anx-reader.
English | 简体中文 | 繁體中文 | Español | Français | Deutsch
✨ Características
- Soporte Multilingüe: Soporte completo de internacionalización. La interfaz está disponible en inglés, chino simplificado (简体中文), chino tradicional (繁體中文), español, francés y alemán.
- Interfaz Orientada a Móviles: Una interfaz de usuario limpia y adaptable diseñada para un uso fácil en tu teléfono.
- Soporte PWA: Se puede instalar como una Aplicación Web Progresiva para una experiencia similar a la nativa.
- Visualizador de libros en el navegador: Previsualiza libros electrónicos directamente en tu navegador. Incluye función de texto a voz (TTS).
- Generación de Audiolibros: Convierte libros EPUB en audiolibros M4B con marcadores de capítulo, utilizando proveedores de Texto a Voz (TTS) configurables (por ejemplo, Microsoft Edge TTS). Los archivos M4B generados son totalmente compatibles con servidores de audiolibros como Audiobookshelf.
- Reproductor de Audiolibros en Línea: Escucha tus audiolibros M4B generados directamente en el navegador. Tu progreso de escucha se guarda y sincroniza automáticamente.
- Preguntar a la IA: Mantén conversaciones con tus libros. Esta función te permite chatear con cualquier libro de tu biblioteca, hacer preguntas sobre su contenido, obtener resúmenes o explorar temas a través de una interfaz impulsada por IA.
- Integración con Calibre: Se conecta a tu servidor Calibre existente para navegar y buscar en tu biblioteca.
- Sincronización con KOReader: Sincroniza tu progreso de lectura y tiempo de lectura con dispositivos KOReader.
- Envío Inteligente a Kindle: Maneja automáticamente los formatos al enviar a tu Kindle. Si existe un EPUB, se envía directamente. Si no, la aplicación convierte el mejor formato disponible a EPUB según tus preferencias antes de enviarlo, asegurando una compatibilidad óptima.
- Enviar a Anx: Envía libros de tu biblioteca de Calibre directamente a la carpeta de tu dispositivo Anx-reader personal.
- Servidor WebDAV Integrado: Cada usuario obtiene su propia carpeta WebDAV segura, compatible con Anx-reader y otros clientes WebDAV.
- Servidor MCP: Un servidor incorporado y compatible con el Protocolo de Contexto de Modelo (MCP), que permite a agentes de IA y herramientas externas interactuar de forma segura con tu biblioteca.
- Gestión de Usuarios: Sistema de gestión de usuarios simple e integrado con roles distintos:
- Administrador: Control total sobre usuarios, configuraciones globales y todos los libros.
- Mantenedor: Puede editar los metadatos de todos los libros.
- Usuario: Puede subir libros, gestionar su propia biblioteca WebDAV, tokens MCP, enviar libros a Kindle y editar los libros que ha subido.
- Registro solo por Invitación: Los administradores pueden generar códigos de invitación para controlar el registro de usuarios. Esta función está habilitada por defecto para evitar registros no autorizados.
- Libros Subidos Editables por el Usuario: Los usuarios regulares ahora pueden editar los metadatos de los libros que han subido. Esta funcionalidad se basa en una columna personalizada de Calibre llamada
#library(tipo:Texto). Cuando un usuario sube un libro, su nombre de usuario se guarda automáticamente en este campo. Los usuarios pueden editar cualquier libro en el que figuren como propietarios en el campo#library.- Recomendación para Usuarios de Docker: Para habilitar esta función, asegúrate de tener una columna personalizada en tu biblioteca de Calibre llamada
#library(sensible a mayúsculas y minúsculas) con el tipoTexto.
- Recomendación para Usuarios de Docker: Para habilitar esta función, asegúrate de tener una columna personalizada en tu biblioteca de Calibre llamada
- Despliegue Fácil: Desplegable como un único contenedor de Docker con soporte de localización multilingüe incorporado.
- Estadísticas de Lectura: Genera automáticamente una página personal de estadísticas de lectura, con un mapa de calor de lectura anual, una lista de libros que se están leyendo actualmente y una lista de libros terminados. La página se puede compartir públicamente o mantener privada.
📸 Capturas de Pantalla
Interfaz Principal
Página de Configuración
Configuración de MCP
| Chat de MCP | Chat de MCP | Chat de MCP | Chat de MCP |
|---|---|---|---|
![]() |
![]() |
![]() |
![]() |
| Estado del Libro de Koreader | Sincronización de Koreader |
|---|---|
![]() |
![]() |
| Configuración de Koreader | WebDAV de Koreader |
|---|---|
![]() |
![]() |
Página de Estadísticas
| Lista de audiolibros | Reproductor de audiolibros |
|---|---|
![]() |
![]() |
| Chatear con el libro | Chatear con el libro |
|---|---|
![]() |
![]() |
🚀 Despliegue
Esta aplicación está diseñada para ser desplegada usando Docker.
Prerrequisitos
- Docker instalado en tu servidor.
- Servidor Calibre (elige una opción):
- Opción 1: Usar imagen AIO (Todo en Uno) - Incluye un
calibre-serverintegrado. Perfecto para usuarios que desean un despliegue simple en un solo contenedor. - Opción 2: Usar un servidor Calibre existente - Ejecuta una imagen Docker de servidor Calibre separada. Recomendado: linuxserver/calibre o ligero: lucapisciotta/calibre (puerto predeterminado:
8085).
- Opción 1: Usar imagen AIO (Todo en Uno) - Incluye un
Inicio Rápido (Docker Run)
Versión AIO (Todo en Uno - Recomendado)
¡Perfecto si no quieres gestionar un servidor Calibre separado!
Crea tres directorios para los datos persistentes:
mkdir -p ./config mkdir -p ./webdav mkdir -p ./libraryEjecuta el contenedor Docker AIO:
docker run -d \ --name anx-calibre-manager-aio \ -p 5000:5000 \ -p 8080:8080 \ -v $(pwd)/config:/config \ -v $(pwd)/webdav:/webdav \ -v "$(pwd)/library:/Calibre Library" \ -e CALIBRE_URL=http://localhost:8080 \ -e CALIBRE_USERNAME=admin \ -e CALIBRE_PASSWORD=password \ --restart unless-stopped \ ghcr.io/ptbsare/anx-calibre-manager:aio-latestAccede a la aplicación en
http://localhost:5000. El servidor Calibre integrado estará disponible enhttp://localhost:8080.- Nota: El directorio
/Calibre Libraryes tu carpeta de biblioteca de Calibre. Contendrámetadata.db(la base de datos de Calibre), archivos de libros e imágenes de portadas. Aquí es donde el servidor Calibre integrado almacena y gestiona todos tus ebooks. - Nota: Cambia el nombre de usuario (
admin) y la contraseña (password) predeterminados por seguridad.
- Nota: El directorio
Versión Estándar
Para usuarios que ya tienen un servidor Calibre separado.
Crea dos directorios para los datos persistentes:
mkdir -p ./config mkdir -p ./webdavEjecuta el contenedor de Docker con este único comando:
docker run -d \ --name anx-calibre-manager \ -p 5000:5000 \ -v $(pwd)/config:/config \ -v $(pwd)/webdav:/webdav \ --restart unless-stopped \ ghcr.io/ptbsare/anx-calibre-manager:latestAccede a la aplicación en
http://localhost:5000. El primer usuario que se registre se convertirá en el administrador. Puedes configurar la conexión al servidor de Calibre y otros ajustes desde la interfaz web más tarde.
Configuración Avanzada
Aquí tienes un ejemplo más detallado de docker-compose.yml para usuarios que quieran conectarse a un servidor de Calibre y personalizar más opciones.
Encuentra tu ID de Usuario y Grupo (PUID/PGID): Ejecuta
id $USERen tu máquina anfitriona. Se recomienda para evitar problemas de permisos.Crea un archivo
docker-compose.yml:services: anx-calibre-manager: image: ghcr.io/ptbsare/anx-calibre-manager:latest container_name: anx-calibre-manager ports: - "5000:5000" volumes: - /ruta/a/tu/config:/config - /ruta/a/tu/webdav:/webdav - /ruta/a/tu/audiobooks:/audiobooks # Opcional - /ruta/a/tus/fuentes:/opt/share/fonts # Opcional environment: - PUID=1000 - PGID=1000 - TZ=America/New_York - GUNICORN_WORKERS=2 # Opcional - SECRET_KEY=tu_clave_super_secreta # ¡Cambia esto! - CALIBRE_URL=http://ip-de-tu-servidor-calibre:8080 - CALIBRE_USERNAME=tu_usuario_calibre - CALIBRE_PASSWORD=tu_contraseña_calibre - CALIBRE_DEFAULT_LIBRARY_ID=Calibre_Library - CALIBRE_ADD_DUPLICATES=false restart: unless-stoppedNota: Reemplaza
/ruta/a/tu/...con las rutas reales en tu máquina anfitriona.Ejecuta el contenedor:
docker-compose up -d
Fuentes Personalizadas
La herramienta de conversión de libros, ebook-converter, escanea el directorio /opt/share/fonts en busca de fuentes. Si encuentras problemas relacionados con las fuentes al convertir libros con caracteres especiales (por ejemplo, chino), puedes proporcionar fuentes personalizadas montando un directorio local que contenga tus archivos de fuentes (por ejemplo, .ttf, .otf) en la ruta /opt/share/fonts del contenedor.
Configuración
La aplicación se configura a través de variables de entorno.
| Variable | Descripción | Predeterminado |
|---|---|---|
PUID |
El ID de usuario con el que se ejecuta la aplicación. | 1001 |
PGID |
El ID de grupo con el que se ejecuta la aplicación. | 1001 |
TZ |
Tu zona horaria, ej., America/New_York. |
UTC |
PORT |
El puerto en el que la aplicación escucha dentro del contenedor. | 5000 |
GUNICORN_WORKERS |
Opcional: El número de procesos de trabajo de Gunicorn. | 2 |
CONFIG_DIR |
El directorio para la base de datos y settings.json. |
/config |
WEBDAV_DIR |
El directorio base para los archivos de usuario de WebDAV. | /webdav |
SECRET_KEY |
Requerido. Una cadena larga y aleatoria para la seguridad de la sesión. | "" |
LOGIN_MAX_ATTEMPTS |
Número máximo de intentos de inicio de sesión antes del bloqueo de cuenta. Establece en 0 para deshabilitar. |
5 |
SESSION_LIFETIME_DAYS |
Número de días que una sesión de usuario permanece válida después del inicio de sesión. | 7 |
ENABLE_ACTIVITY_LOG |
Habilita el registro de actividades del usuario (inicio de sesión, descarga, carga, etc.) en la base de datos con fines de auditoría. | false |
CALIBRE_URL |
La URL de tu servidor de contenido de Calibre. Doble propósito en la versión AIO: (1) Sirve como la configuración de conexión predeterminada global del servidor Calibre para anx-calibre-manager. (2) El número de puerto se extrae para determinar en qué puerto debe escuchar el calibre-server integrado. Por ejemplo, http://localhost:8080 hará que calibre-server escuche en el puerto 8080. Consulta Solución de Problemas si tienes problemas de conexión. |
"" |
CALIBRE_USERNAME |
Nombre de usuario para tu servidor Calibre. Consulta Solución de Problemas si tienes problemas de conexión. | "" |
CALIBRE_PASSWORD |
Contraseña para tu servidor Calibre. Consulta Solución de Problemas si tienes problemas de conexión. | "" |
CALIBRE_DEFAULT_LIBRARY_ID |
El ID de la biblioteca de Calibre predeterminada. Para más detalles, consulta Cómo encuentro mi library_id. |
Calibre_Library |
CALIBRE_ADD_DUPLICATES |
Si se permite subir libros duplicados. | false |
DISABLE_NORMAL_USER_UPLOAD |
Cuando se establece en true, deshabilita la función de carga de libros para usuarios con el rol 'Usuario', solo los Administradores y Mantenedores pueden cargar libros. |
false |
REQUIRE_INVITE_CODE |
Si se requiere un código de invitación para el registro. | true |
SMTP_SERVER |
Servidor SMTP para enviar correos electrónicos (ej., para Kindle). | "" |
SMTP_PORT |
Puerto SMTP. | 587 |
SMTP_USERNAME |
Nombre de usuario SMTP. | "" |
SMTP_PASSWORD |
Contraseña SMTP. | "" |
SMTP_ENCRYPTION |
Tipo de cifrado SMTP (ssl, starttls, none). |
ssl |
DEFAULT_TTS_PROVIDER |
El proveedor de TTS predeterminado para la generación de audiolibros (edge_tts o openai_tts). |
edge_tts |
DEFAULT_TTS_VOICE |
La voz predeterminada para el proveedor de TTS seleccionado. | en-US-AriaNeural |
DEFAULT_TTS_RATE |
La velocidad de habla predeterminada para el proveedor de TTS (por ejemplo, +10%). |
+0% |
DEFAULT_TTS_SENTENCE_PAUSE |
La duración de la pausa predeterminada entre oraciones en milisegundos. | 650 |
DEFAULT_TTS_PARAGRAPH_PAUSE |
La duración de la pausa predeterminada entre párrafos en milisegundos. | 900 |
DEFAULT_OPENAI_API_KEY |
Tu clave de API de OpenAI (requerida si se usa openai_tts). |
"" |
DEFAULT_OPENAI_API_BASE_URL |
URL base personalizada para APIs compatibles con OpenAI. | https://api.openai.com/v1 |
DEFAULT_OPENAI_API_MODEL |
El modelo de OpenAI a utilizar para TTS (por ejemplo, tts-1). |
tts-1 |
DEFAULT_LLM_BASE_URL |
La URL base para la API del Modelo de Lenguaje Grande (LLM), compatible con el formato de la API de OpenAI. | "" |
DEFAULT_LLM_API_KEY |
La clave de API para el servicio LLM. | "" |
DEFAULT_LLM_MODEL |
El modelo predeterminado a utilizar para el servicio LLM (por ejemplo, gpt-4). |
"" |
🔧 Solución de Problemas
Aquí hay algunos problemas comunes y sus soluciones:
1. ¿Por qué no hay libros en mi lista de Calibre?
- R: Asegúrate de haber iniciado el Servidor de Contenido de Calibre en tu cliente o contenedor de Calibre. Generalmente se ejecuta en el puerto
8080. Recuerda que esta aplicación se conecta acalibre-server, no acalibre-web(que normalmente se ejecuta en el puerto8083). - R: Verifica que la URL de tu servidor Calibre, el nombre de usuario y la contraseña sean correctos en la configuración. Puedes probar esto abriendo la URL configurada en tu navegador e intentando iniciar sesión.
2. ¿Por qué recibo un error 401 Unauthorized al subir/editar libros?
- R: Asegúrate de que la cuenta de usuario de Calibre que configuraste tenga permisos de escritura para la biblioteca. Para verificarlo, ve a
Preferencias->Compartir por la red->Cuentas de usuarioen la aplicación de escritorio de Calibre y asegúrate de que la opción "Permitir acceso de escritura" esté marcada para el usuario.
3. ¿Por qué recibo un error 403 Forbidden al subir/editar libros?
- R: Esto generalmente significa que has configurado un ID de Biblioteca de Calibre incorrecto.
4. ¿Cómo encuentro mi library_id?
- Método 1 (Visual): Abre tu Servidor de Contenido de Calibre en un navegador e inicia sesión. Mira el nombre de tu biblioteca que se muestra en la página. El
library_idsuele ser este nombre con los espacios y caracteres especiales reemplazados por guiones bajos. Por ejemplo, si tu biblioteca se llama "Calibre Library", el ID probablemente seaCalibre_Library. - Método 2 (Desde la URL): En la interfaz del Servidor de Contenido, haz clic en el nombre de tu biblioteca. Mira la URL en la barra de direcciones de tu navegador. Deberías ver un parámetro como
library_id=.... El valor de este parámetro es tu ID de biblioteca (podría estar codificado para URL, por lo que es posible que necesites decodificarlo). - IDs Predeterminados Comunes: El ID de la biblioteca predeterminada a menudo depende del idioma de tu sistema cuando ejecutaste Calibre por primera vez. Aquí hay algunos valores predeterminados comunes:
- Inglés:
Calibre_Library - Francés:
Bibliothèque_calibre - Alemán:
Calibre-Bibliothek - Español:
Biblioteca_de_calibre - Chino Simplificado (简体中文):
Calibre_书库 - Chino Tradicional (繁體中文):
calibre_書庫
- Inglés:
5. ¿Por qué recibo un error 400 Bad Request al editar la fecha de lectura o los campos de la biblioteca?
- R: Este error ocurre porque a tu biblioteca de Calibre le faltan las columnas personalizadas necesarias para almacenar esta información. Para habilitar funciones como el seguimiento de quién subió/es dueño de un libro y establecer una fecha de lectura específica, necesitas añadir dos columnas personalizadas en tu aplicación de escritorio de Calibre:
- Ve a
Preferencias->Añadir columnas personalizadas. - Haz clic en
Añadir columna personalizada. - Crea la primera columna con los siguientes detalles:
- Nombre de búsqueda:
#library - Encabezado de columna:
Library(o como prefieras) - Tipo de columna:
Texto
- Nombre de búsqueda:
- Crea la segunda columna con estos detalles:
- Nombre de búsqueda:
#readdate - Encabezado de columna:
Read Date(o como prefieras) - Tipo de columna:
Fecha
- Nombre de búsqueda:
- Haz clic en
Aplicary reinicia tu servidor de Calibre si está en funcionamiento. Después de añadir estas columnas, las funciones de edición funcionarán correctamente.
- Ve a
6. ¿Por qué no hay un botón para eliminar libros de Calibre en el panel izquierdo?
Esta es una característica de seguridad intencional. Cuando Anx Calibre Manager se expone a Internet público, para evitar la eliminación accidental o maliciosa de libros en su biblioteca (especialmente bibliotecas con miles de libros), no proporcionamos una interfaz para eliminar libros de Calibre.
Para eliminar libros de Calibre, utilice uno de los siguientes métodos:
- Acceda al Servidor de Contenido de Calibre a través de la red interna (puerto predeterminado
8080) para realizar la eliminación - O use el cliente de escritorio de Calibre para la gestión
Esto garantiza que su biblioteca pueda disfrutar de la conveniencia de Anx Calibre Manager sin el riesgo de pérdida de datos por estar expuesta a Internet público.
7. No quiero usar el pesado cliente de escritorio de Calibre o el básico calibre-server para gestionar mi biblioteca. ¿Puedo usar otros frontends como Calibre-Web, Calibre-Web-Automated o Talebook?
¡Sí! Puedes usar cualquier frontend compatible con Calibre junto con esta aplicación. Estos frontends interactúan con la misma base de datos de la biblioteca de Calibre (metadata.db), como se muestra en este diagrama:
Enfoque recomendado: Patrón Sidecar
Ejecuta tu frontend preferido como un contenedor separado que comparte el mismo directorio de biblioteca. Esto funciona especialmente bien con la versión AIO:
Ejemplo con Calibre-Web-Automated:
Usando Docker Run:
# Ejecutar ANX Calibre Manager AIO (incluye calibre-server)
docker run -d \
--name anx-calibre-manager-aio \
-p 5000:5000 \
-p 8080:8080 \
-v $(pwd)/config:/config \
-v $(pwd)/webdav:/webdav \
-v "$(pwd)/library:/Calibre Library" \
-e CALIBRE_URL=http://localhost:8080 \
-e CALIBRE_USERNAME=admin \
-e CALIBRE_PASSWORD=password \
ghcr.io/ptbsare/anx-calibre-manager:aio-latest
# Ejecutar Calibre-Web-Automated (comparte la biblioteca)
docker run -d \
--name calibre-web-automated \
-p 8083:8083 \
-v $(pwd)/library:/calibre-library:rw \
-v $(pwd)/cwa-config:/config \
-e PUID=1000 \
-e PGID=1000 \
ghcr.io/crocodilestick/calibre-web-automated:latest
Usando Docker Compose:
services:
anx-calibre-manager-aio:
image: ghcr.io/ptbsare/anx-calibre-manager:aio-latest
container_name: anx-calibre-manager-aio
ports:
- "5000:5000"
- "8080:8080"
volumes:
- ./config:/config
- ./webdav:/webdav
- "./library:/Calibre Library"
environment:
- CALIBRE_URL=http://localhost:8080
- CALIBRE_USERNAME=admin
- CALIBRE_PASSWORD=password
restart: unless-stopped
calibre-web-automated:
image: ghcr.io/crocodilestick/calibre-web-automated:latest
container_name: calibre-web-automated
ports:
- "8083:8083"
volumes:
- ./library:/calibre-library:rw
- ./cwa-config:/config
environment:
- PUID=1000
- PGID=1000
restart: unless-stopped
Puntos clave:
- Biblioteca compartida: Monta el mismo directorio de biblioteca (
./library) en todos los contenedores - Sin conflictos: Cada frontend se ejecuta en su propio puerto (ANX: 5000, calibre-server: 8080, CWA: 8083)
- Servicios independientes: Cada contenedor se puede iniciar/detener de forma independiente
- Funciona con la versión estándar: También puedes usar este patrón con la versión estándar (no AIO) si ya tienes un servidor Calibre separado
📖 Sincronización con KOReader
Puedes sincronizar tu progreso de lectura y tiempo de lectura entre tu biblioteca Anx y los dispositivos KOReader. La configuración implica dos pasos principales: configurar WebDAV para acceder a tus libros y configurar el complemento de sincronización para manejar la sincronización del progreso.
Paso 1: Configurar Almacenamiento en la Nube WebDAV
Este paso te permite navegar y leer los libros de tu biblioteca Anx directamente en KOReader.
- En KOReader, ve a
Almacenamiento en la nube->Añadir nuevo almacenamiento en la nube. - Selecciona
WebDAV. - Completa los detalles:
- Dirección del servidor: Ingresa la URL de WebDAV que se muestra en la página de configuración de Anx Calibre Manager (
Configuración->Configuración de Sincronización de Koreader). Asegúrate de que la ruta termine con un/. - Nombre de usuario: Tu nombre de usuario de Anx Calibre Manager.
- Contraseña: Tu contraseña de inicio de sesión de Anx Calibre Manager.
- Carpeta:
/anx/data/file
- Dirección del servidor: Ingresa la URL de WebDAV que se muestra en la página de configuración de Anx Calibre Manager (
- Toca
Conectary guarda. Ahora deberías poder ver tu biblioteca Anx en el explorador de archivos de KOReader.
Paso 2: Instalar y Configurar el Complemento de Sincronización
Este complemento envía tu progreso de lectura de vuelta al servidor de Anx Calibre Manager.
- Descargar el Complemento:
- Inicia sesión en Anx Calibre Manager.
- Ve a
Configuración->Configuración de Sincronización de Koreader. - Haz clic en el botón
Descargar Complemento de KOReader (.zip)para obtener el paquete del complemento.
- Instalar el Complemento:
- Descomprime el archivo descargado para obtener una carpeta llamada
anx-calibre-manager-koreader-plugin.koplugin. - Copia esta carpeta completa al directorio
koreader/plugins/en tu dispositivo KOReader.
- Descomprime el archivo descargado para obtener una carpeta llamada
- Reiniciar KOReader: Cierra y vuelve a abrir completamente la aplicación KOReader para cargar el nuevo complemento.
- Configurar el Servidor de Sincronización:
- Importante: Primero, abre un libro desde el almacenamiento WebDAV que configuraste en el Paso 1. El menú del complemento solo es visible en la vista de lectura.
- En la vista de lectura, ve a
Herramientas (icono de llave inglesa)->Página siguiente->Más herramientas->ANX Calibre Manager. - Selecciona
Servidor de sincronización personalizado. - Dirección del servidor de sincronización personalizado: Ingresa la URL del servidor de sincronización que se muestra en la página de configuración de Anx Calibre Manager (ej.,
http://<tu_direccion_de_servidor>/koreader). - Vuelve al menú anterior, selecciona
Iniciar sesióne ingresa tu nombre de usuario y contraseña de Anx Calibre Manager.
Una vez configurado, el complemento sincronizará automática o manualmente tu progreso de lectura. Puedes ajustar configuraciones como la frecuencia de sincronización en el menú del complemento. Nota: Solo se admite el progreso de libros en formato EPUB.
🤖 Servidor MCP
Esta aplicación incluye un servidor MCP (Protocolo de Contexto de Modelo) compatible con JSON-RPC 2.0, que permite a herramientas externas y agentes de IA interactuar con tu biblioteca.
Cómo Usar
- Generar un Token: Después de iniciar sesión, ve a la página Configuración -> Configuración de MCP. Haz clic en "Generar Nuevo Token" para crear un nuevo token de API.
- URL del Endpoint: El endpoint del servidor MCP es
http://<tu_direccion_de_servidor>/mcp. - Autenticación: Autentícate añadiendo tu token como un parámetro de consulta a la URL, ej.,
http://.../mcp?token=TU_TOKEN. - Enviar Solicitudes: Envía solicitudes
POSTa este endpoint con un cuerpo que cumpla con el formato JSON-RPC 2.0.
Ejemplos de Prompts
Aquí tienes algunos ejemplos de prompts en lenguaje natural que podrías usar con un agente de IA que tenga acceso a estas herramientas. El agente llamaría de forma inteligente a una o más herramientas para satisfacer tu solicitud.
Búsqueda Simple y Avanzada:
"Encuentra libros sobre programación en Python."
"Busca libros de ciencia ficción de Isaac Asimov publicados después de 1950."
Gestión de Libros:
"¿Cuáles son los 5 libros añadidos más recientemente? Envía el primero a mi Kindle."
"Empuja el libro 'Dune' a mi lector Anx."
"Sube el libro 'El Problema de los Tres Cuerpos' de mi biblioteca Anx a Calibre."
"Genera un audiolibro para el libro 'El problema de los tres cuerpos'."
"¿Cuál es el estado de la generación del audiolibro para 'El problema de los tres cuerpos'?"
Interacción y Resumen de Contenido:
"Muéstrame la tabla de contenidos del libro 'Fundación'."
"Obtén el primer capítulo de 'Fundación' y dame un resumen."
"Basado en el capítulo 'Los Psicohistoriadores' del libro 'Fundación', ¿cuáles son las ideas principales de la psicohistoria?"
"Lee el libro completo 'El Principito' y dime cuál es el secreto del zorro."
Estadísticas y Progreso de Lectura:
"¿Cuántas palabras tiene el libro 'Dune' en total y enumera el recuento de palabras de cada capítulo?"
"¿Cuántos libros he leído este año?"
"¿Cuál es mi progreso de lectura en 'Dune'?"
"¿Quién es el autor de 'Proyecto Hail Mary' y cuánto tiempo llevo leyéndolo?"
Herramientas Disponibles
Puedes obtener una lista de todas las herramientas disponibles llamando al método tools/list. Las herramientas actualmente soportadas son:
search_calibre_books: Busca libros en Calibre utilizando la potente sintaxis de búsqueda de Calibre.- Parámetros:
search_expression(cadena),limit(entero, opcional). - Ejemplo (Búsqueda Avanzada): Encuentra libros de "O'Reilly Media" con una calificación de 4 estrellas o más.
{ "jsonrpc": "2.0", "method": "tools/call", "params": { "name": "search_calibre_books", "arguments": { "search_expression": "publisher:\"O'Reilly Media\" AND rating:>=4", "limit": 10 } }, "id": "search-request-1" }
- Parámetros:
get_recent_books: Obtiene libros recientes de una biblioteca específica.- Parámetros:
library_type(cadena, 'anx' o 'calibre'),limit(entero, opcional).
- Parámetros:
get_book_details: Obtiene detalles de un libro específico en una biblioteca.- Parámetros:
library_type(cadena, 'anx' o 'calibre'),book_id(entero).
- Parámetros:
push_calibre_book_to_anx: Envía un libro de la biblioteca de Calibre a la biblioteca Anx del usuario.- Parámetros:
book_id(entero).
- Parámetros:
push_anx_book_to_calibre: Sube un libro de la biblioteca Anx del usuario a la biblioteca pública de Calibre.- Parámetros:
book_id(entero).
- Parámetros:
send_calibre_book_to_kindle: Envía un libro de la biblioteca de Calibre al correo electrónico de Kindle configurado por el usuario.- Parámetros:
book_id(entero).
- Parámetros:
get_table_of_contents: Obtiene la tabla de contenidos de un libro de una biblioteca específica.- Parámetros:
library_type(cadena, 'anx' o 'calibre'),book_id(entero).
- Parámetros:
get_chapter_content: Obtiene el contenido de un capítulo específico de un libro.- Parámetros:
library_type(cadena, 'anx' o 'calibre'),book_id(entero),chapter_number(entero).
- Parámetros:
get_entire_book_content: Obtiene el contenido de texto completo de un libro de una biblioteca específica.- Parámetros:
library_type(cadena, 'anx' o 'calibre'),book_id(entero).
- Parámetros:
get_word_count_statistics: Obtiene estadísticas de recuento de palabras para un libro (total y por capítulo).- Parámetros:
library_type(cadena, 'anx' o 'calibre'),book_id(entero).
- Parámetros:
generate_audiobook: Genera un audiolibro para un libro de la biblioteca Anx o Calibre.- Parámetros:
library_type(cadena, 'anx' o 'calibre'),book_id(entero).
- Parámetros:
get_audiobook_generation_status: Obtiene el estado de una tarea de generación de audiolibros por su ID de tarea.- Parámetros:
task_id(cadena).
- Parámetros:
get_audiobook_status_by_book: Obtiene el estado de la última tarea de audiolibro para un libro específico por su ID y tipo de biblioteca.- Parámetros:
library_type(cadena, 'anx' o 'calibre'),book_id(entero).
- Parámetros:
get_user_reading_stats: Obtiene estadísticas de lectura para el usuario actual.- Parámetros:
time_range(cadena). Este parámetro es obligatorio. Puede ser "all", "today", "this_week", "this_month", "this_year", un número de días recientes (por ejemplo, "7", "30") o un rango de fechas "AAAA-MM-DD:AAAA-MM-DD".
- Parámetros:
💻 Desarrollo
Clona el repositorio:
git clone https://github.com/ptbsare/anx-calibre-manager.git cd anx-calibre-managerCrea un entorno virtual:
python3 -m venv .venv source .venv/bin/activateInstala las dependencias:
pip install -r requirements.txtEjecuta el servidor de desarrollo:
python app.pyLa aplicación estará disponible en
http://localhost:5000.
🤝 Contribuciones
¡Las contribuciones, problemas y solicitudes de características son bienvenidos! Siéntete libre de revisar la página de problemas.
🙏 Agradecimientos
Este proyecto utiliza los siguientes proyectos de código abierto:
- foliate-js por proporcionar la funcionalidad de vista previa de libros electrónicos.
- ebook-converter por proporcionar la funcionalidad de conversión de libros electrónicos.
📄 Licencia
Este proyecto está licenciado bajo la Licencia GPLv3.











