apple-books-mcp

Apple Books MCP

Сервер протокола контекста модели (MCP) для Apple Books.

С первого взгляда

Попросите Клода подвести итог вашим последним событиям.
Попросите Клода отсортировать книги в вашей библиотеке по жанрам.
Попросите Клода порекомендовать вам похожие книги на основе вашей истории чтения.
Попросите Клода сравнить заметки из разных книг, прочитанных на одну и ту же тему.

https://github.com/user-attachments/assets/77a5a29b-bfd7-4275-a4af-8d6c51a4527e

И многое другое!

Доступные инструменты

Инструмент	Описание	Параметры
список_коллекций()	Список всех коллекций	Никто
получить_коллекции_книг(коллекция_идентификатор)	Получить все книги в коллекции	collection_id: ул
describe_collection(идентификатор_коллекции)	Получить подробную информацию о коллекции	collection_id: ул
список_всех_книг()	Список всех книг	Никто
получить_аннотации_книг(идентификатор_книги)	Получить все аннотации к книге	book_id: ул
describe_book(идентификатор_книги)	Получить подробную информацию о конкретной книге	book_id: ул
список_всех_аннотаций()	Список всех аннотаций	Никто
получить_выделения_по_цвету(цвет)	Получить все основные моменты по цвету	цвет: стр
поиск_выделенный_текст(текст)	Поиск основных моментов по выделенному тексту	текст: ул
search_notes(заметка)	Поиск заметок	примечание: ул
полный_текстовый_поиск(текст)	Поиск аннотаций, содержащих заданный текст	текст: ул
недавние_аннотации()	Получите 10 последних аннотаций	Никто
describe_annotation(идентификатор_аннотации)	Получить подробную информацию об аннотации	annotation_id: str

Установка

Использование УФ (рекомендуется)

uvx можно использовать для непосредственного запуска apple-books-mcp (без его установки).

brew install uv  # for macos
uvx apple-books-mcp

Использование пипа

pip install apple-books-mcp

После установки вы можете запустить сервер с помощью:

python -m apple_books_mcp

Конфигурация

Настройка рабочего стола Клода

Использование uvx (рекомендуется)

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

Использование питона

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

Предстоящие функции

[ ] добавить поддержку докера
[ ] добавить поддержку ресурсов
[ ] поддержка редактирования коллекций
[ ] редактировать основные моменты поддержка

Вклад

Спасибо, что решили внести свой вклад в этот проект!

Разработка

Если вы клонировали этот репозиторий, вы можете протестировать его с помощью Claude Desktop со следующей конфигурацией:

Используйте uv venv для создания виртуальной среды и установки зависимостей.

uv venv
uv sync

Отладка

С Клодом Десктопом

{
    "mcpServers": {
        "apple-books-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/apple-books-mcp/",
                "run",
                "apple_books_mcp",
                "-v"
            ]
        }
    }
}

С инспектором

npx @modelcontextprotocol/inspector uvx apple-books-mcp

Открытие вопросов

Если вы столкнулись с ошибкой, у вас есть запрос на функцию или вы хотите обсудить что-то, связанное с проектом, пожалуйста, откройте issue в репозитории GitHub. При открытии issue, пожалуйста, предоставьте:

Отчеты об ошибках : подробно опишите проблему. Если возможно, включите шаги по воспроизведению ошибки, а также любые сообщения об ошибках или скриншоты.

Запросы функций : четко объясните, какую новую функцию вы хотели бы добавить в проект. Предоставьте контекст того, почему эта функция будет полезна.

Общие обсуждения : Не стесняйтесь начинать обсуждения на более широкие темы, связанные с проектом.

Внося вклад

1️⃣ Форк репозитория GitHub https://github.com/vgnshiyer/apple-books-mcp
2️⃣ Создайте новую ветку для своих изменений (git checkout -b feature/my-new-feature).
3️⃣ Внесите изменения и тщательно протестируйте их.
4️⃣ Отправьте свои изменения и откройте запрос на извлечение в main .

Пожалуйста, дайте четкое название и описание ваших изменений.

Лицензия

Apple Books MCP лицензирован по лицензии Apache 2.0. Подробности см. в файле LICENSE.

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.

Сервер Apple Books MCP устраняет разрыв между вашим личным путешествием по чтению и возможностями искусственного интеллекта, преобразуя статичные коллекции книг в интерактивные хранилища знаний.

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
9
26
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 -
73
TypeScript
MIT License
Aladin Book Search MCP Server
TeeDDub
A
security
F
license
A
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 -
9
3
JavaScript

View all related MCP servers