libros de manzana-mcp

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).

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.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

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.

Related MCP Servers

macOS Defaults MCP Server
g0t4
A
security
F
license
A
quality
MCP server that enables reading and writing macOS system preferences and application settings through the defaults system.
Last updated -
4
11
Python
mcp-open-library
8enSmith
A
security
A
license
A
quality
A Model Context Protocol (MCP) server for the Open Library API that enables AI assistants to search for book information.
Last updated -
1
13
19
TypeScript
MIT License
Notes MCP
krasun
-
security
A
license
-
quality
An MCP server that enables AI assistants like Claude to access and manipulate Apple Notes on macOS, allowing for retrieving, creating, and managing notes through natural language interactions.
Last updated -
70
TypeScript
MIT License
Aladin Book Search MCP Server
TeeDDub
-
security
F
license
-
quality
MCP server that allows searching and retrieving book information from Aladin's book store API, including book details, bestseller lists, and category-based searches.
Last updated -
3
JavaScript

View all related MCP servers

apple-books-mcp