Integrations
Provides tools for interacting with Apple Books, allowing access to book collections, detailed book information, and annotation management including highlights and notes.
Provides support for the developer through donation links to Buy Me A Coffee platform.
Facilitates contribution to the project through the GitHub repository, including issue reporting and pull request submission.
Apple Books MCP
Servidor de Protocolo de Contexto de Modelo (MCP) para Apple Books.
De un vistazo
- Pídele a Claude que resuma tus momentos destacados más recientes
- Pídele a Claude que organice los libros de tu biblioteca por género
- Pídele a Claude que te recomiende libros similares según tu historial de lectura.
- Pídele a Claude que compare notas de diferentes libros leídos sobre el mismo tema.
https://github.com/user-attachments/assets/77a5a29b-bfd7-4275-a4af-8d6c51a4527e
¡Y mucho más!
Herramientas disponibles
| Herramienta | Descripción | Parámetros |
|---|---|---|
| lista_colecciones() | Listar todas las colecciones | Ninguno |
| obtener_libros_de_colección(id_de_colección) | Obtener todos los libros de una colección | id_de_colección: str |
| describe_colección(id_colección) | Obtener detalles de una colección | id_de_colección: str |
| lista_todos_los_libros() | Listar todos los libros | Ninguno |
| obtener_anotaciones_del_libro(id_del_libro) | Obtener todas las anotaciones de un libro | id_libro: str |
| describe_libro(id_libro) | Obtener detalles de un libro en particular | id_libro: str |
| lista_todas_las_anotaciones() | Listar todas las anotaciones | Ninguno |
| obtener_resaltados_por_color(color) | Obtenga todos los aspectos destacados por color | color: str |
| texto resaltado de búsqueda(texto) | Buscar destacados por texto resaltado | texto: str |
| buscar_notas(nota) | Buscar notas | nota: str |
| búsqueda_de_texto_completo(texto) | Buscar anotaciones que contengan el texto dado | texto: str |
| anotaciones recientes() | Obtenga las 10 anotaciones más recientes | Ninguno |
| describe_annotation(id_de_anotación) | Obtener detalles de una anotación | annotation_id: cadena |
Instalación
Uso de uv (recomendado)
uvx se puede utilizar para ejecutar directamente apple-books-mcp (sin instalarlo).
Usando pip
Después de la instalación, puede ejecutar el servidor usando:
Configuración
Configuración del escritorio de Claude
Uso de uvx (recomendado)
Usando Python
Próximas funciones
- [ ] añadir compatibilidad con Docker
- [ ] añadir soporte de recursos
- [ ] soporte para editar colecciones
- [ ] editar destacados soporte
Contribución
¡Gracias por considerar contribuir a este proyecto!
Desarrollo
Si clonó este repositorio, puede probarlo usando Claude Desktop con la siguiente configuración:
Utilice uv venv para crear un entorno virtual e instalar las dependencias.
Depuración
Con Claude Desktop
Con inspector
Problemas de apertura
Si encuentra un error, tiene una solicitud de función o desea debatir algo relacionado con el proyecto, abra una incidencia en el repositorio de GitHub. Al abrir una incidencia, proporcione:
Informes de errores : Describa el problema detalladamente. Incluya los pasos para reproducir el error, si es posible, junto con cualquier mensaje de error o captura de pantalla.
Solicitudes de funciones : Explique claramente la nueva función que desea que se agregue al proyecto. Proporcione contexto sobre por qué sería beneficiosa.
Discusiones generales : siéntete libre de iniciar discusiones sobre temas más amplios relacionados con el proyecto.
Contribuyendo
1️⃣ Bifurca el repositorio de GitHub https://github.com/vgnshiyer/apple-books-mcp
2️⃣ Crea una nueva rama para tus cambios (git checkout -b feature/my-new-feature).
3️⃣ Realiza tus cambios y pruébalos exhaustivamente.
4️⃣ Envíe sus cambios y abra una solicitud de extracción al main .
Proporcione un título claro y una descripción de sus cambios.
Licencia
Apple Books MCP se rige por la licencia Apache 2.0. Consulte el archivo de LICENCIA para obtener más información.
This server cannot be installed
El servidor MCP de Apple Books cierra la brecha entre su recorrido de lectura personal y las capacidades de IA al transformar colecciones de libros estáticos en repositorios de conocimiento interactivos.