Apple Books MCP

Servidor del Protocolo de Contexto de Modelos (MCP) para Apple Books.

De un vistazo

• Retoma donde lo dejaste — Claude puede ver el capítulo en el que estás y su texto, además de los subrayados recientes en el libro.

• Amplía cualquier subrayado — obtén una explicación del párrafo circundante en contexto, con el ancla exacta que marcaste mostrada en «...».

• Revisita un libro — extrae tus subrayados, agrúpalos por temas y deja que te los cite de vuelta.

• Reflexiona sobre tu lectura — patrones entre libros, ideas recurrentes en tus subrayados, aquello que realmente te atrae.

https://github.com/user-attachments/assets/77a5a29b-bfd7-4275-a4af-8d6c51a4527e

¡Y mucho más!

Related MCP server: Co-Reading MCP

Herramientas disponibles

Colecciones

Libros

Estado de lectura

Anotaciones

Estadísticas de la biblioteca

Contenido del libro

Solo funciona para EPUBs sin DRM (libros importados, Project Gutenberg, Standard Ebooks, etc.). Las compras de la Apple Books Store están protegidas por FairPlay y devuelven un error claro. Los libros solo en iCloud devuelven una pista de "no descargado".

Recursos disponibles

Objetos de datos adjuntables accesibles desde el selector de recursos de Claude Desktop.

Prompts disponibles

Flujos de trabajo de un solo clic, accesibles desde el selector de prompts de Claude Desktop.

Instalación

Usando uv (recomendado)

uvx se puede usar para ejecutar directamente apple-books-mcp (sin instalarlo).

brew install uv  # for macos
uvx apple-books-mcp

Usando pip

pip install apple-books-mcp

Después de instalarlo, puedes ejecutar el servidor usando:

python -m apple_books_mcp

Usando Docker

docker run -v ~/Library/Containers/com.apple.iBooksX/Data/Documents:/root/Library/Containers/com.apple.iBooksX/Data/Documents:ro ghcr.io/vgnshiyer/apple-books-mcp:latest

Solicitud de permiso en la primera ejecución (macOS)

En el primer uso, macOS preguntará si uvx (o python / docker, dependiendo de cómo lo hayas iniciado) puede "acceder a datos de otras aplicaciones". Haz clic en Permitir: el MCP lee el contenedor privado de Apple Books en ~/Library/Containers/com.apple.iBooksX/, que macOS trata como datos en espacio aislado de otra aplicación. El acceso es de solo lectura y está limitado a ese contenedor; el servidor se inicia correctamente de cualquier manera, pero sin permiso, todas las herramientas devuelven resultados vacíos.

Configuración

Configuración de Claude Desktop

Usando uvx (recomendado)

{
    "mcpServers": {
        "apple-books-mcp": {
            "command": "uvx",
            "args": [ "apple-books-mcp@latest" ]
        }
    }
}

Usando python

{
    "mcpServers": {
        "apple-books-mcp": {
            "command": "python",
            "args": ["-m", "apple_books_mcp"]
        }
    }
}

Usando Docker

{
    "mcpServers": {
        "apple-books-mcp": {
            "command": "docker",
            "args": [
                "run", "-i", "--rm",
                "-v", "~/Library/Containers/com.apple.iBooksX/Data/Documents:/root/Library/Containers/com.apple.iBooksX/Data/Documents:ro",
                "ghcr.io/vgnshiyer/apple-books-mcp:latest"
            ]
        }
    }
}

Próximas funciones

• [ ] Acceso al contenido de PDF (actualmente solo EPUB)

• [ ] Contexto de anotación más completo mediante resolución de CFI → párrafo

Contribución

¡Gracias por considerar contribuir a este proyecto!

Desarrollo

Si clonaste este repositorio, puedes probarlo usando Claude Desktop con la siguiente configuración:

Usa uv venv para crear un entorno virtual e instalar las dependencias.

uv venv
uv sync

Depuración

Con Claude Desktop

{
    "mcpServers": {
        "apple-books-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/apple-books-mcp/",
                "run",
                "apple_books_mcp",
                "-v"
            ]
        }
    }
}

Con inspector

npx @modelcontextprotocol/inspector uvx apple-books-mcp

Abrir incidencias

Si encuentras un error, tienes una solicitud de función o quieres discutir algo relacionado con el proyecto, abre una incidencia en el repositorio de GitHub. Al abrir una incidencia, por favor proporciona:

Informes de errores: Describe el problema en detalle. Incluye pasos para reproducir el error si es posible, junto con cualquier mensaje de error o captura de pantalla.

Solicitudes de funciones: Explica claramente la nueva función que te gustaría ver añadida al proyecto. Proporciona contexto sobre por qué esta función sería beneficiosa.

Discusiones generales: Siéntete libre de iniciar discusiones sobre temas más amplios relacionados con el proyecto.

Contribuir

1️⃣ Haz un fork del 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ía tus cambios y abre un Pull Request a main.

Por favor, proporciona un título y una descripción claros de tus cambios.

Licencia

Apple Books MCP tiene la licencia Apache 2.0. Consulta el archivo LICENSE para obtener más detalles.