Skip to main content
Glama
vgnshiyer
by vgnshiyer

Apple Books MCP

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

PyPI Лицензия: Apache 2.0 Купи мне кофе

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

  • Попросите Клода подвести итог вашим последним событиям.

  • Попросите Клода отсортировать книги в вашей библиотеке по жанрам.

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

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

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

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

Related MCP server: mcp-open-library

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

Инструмент

Описание

Параметры

список_коллекций()

Список всех коллекций

Никто

получить_коллекции_книг(коллекция_идентификатор)

Получить все книги в коллекции

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.

-
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