A
security-
licenseA
qualityMCP server that enables reading and writing macOS system preferences and application settings through the defaults system.
Last updated -
4
11
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
Related Resources
Related MCP Servers
- Asecurity-licenseAqualityA Model Context Protocol (MCP) server for the Open Library API that enables AI assistants to search for book information.Last updated -6141MIT License
- -security-license-qualityAn 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 -75MIT License
- AsecurityAlicenseAqualityMCP 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 -93MIT License