Skip to main content
Glama
vgnshiyer
by vgnshiyer

Apple Books MCP

Servidor de Protocolo de Contexto de Modelo (MCP) para Apple Books.

PyPI Licencia: Apache 2.0 Invítame a un café

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

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.

-
security - not tested
A
license - permissive license
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/vgnshiyer/apple-books-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server