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!

Related MCP server: mcp-open-library

Herramientas disponibles

Instalación

Uso de uv (recomendado)

uvx se puede utilizar 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 la instalación, puede ejecutar el servidor usando:

python -m apple_books_mcp

Configuración

Configuración del escritorio de Claude

Uso de uvx (recomendado)

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

Usando Python

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

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.

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

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.