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.

apple-books-mcp

Integrations