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

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

Perplexity AI MCP Server
rileyedwards77
A
security
F
license
A
quality
Provides a standardized way to integrate Perplexity AI's features like chat, search, and documentation access into MCP-based systems.
Last updated -
5
JavaScript
mcp-summarizer
0xshellming
A
security
F
license
A
quality
MCP Server for AI Summarization, Support for multiple content types: * Plain text * Web pages * PDF documents * EPUB books * HTML content
Last updated -
1
9
9
JavaScript
Typesense MCP Server
suhail-ak-s
-
security
A
license
-
quality
An MCP server implementation that enables AI models to discover, search, and analyze data stored in Typesense collections through tools for querying documents, retrieving specific items, and accessing collection statistics.
Last updated -
21
7
TypeScript
MIT License
Documentation Retrieval MCP Server (DOCRET)
Sreedeep-SS
-
security
-
license
-
quality
An MCP server that enables AI assistants to access up-to-date documentation for Python libraries like LangChain, LlamaIndex, and OpenAI through dynamic fetching from official sources.
Last updated -
1
Python
MIT License

View all related MCP servers

apple-books-mcp