Apple Books MCP

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

Краткий обзор

• Продолжайте с того места, где остановились — Claude видит главу, на которой вы остановились, и её текст, а также недавние выделения в книге.

• Разверните любое выделение — получите объяснение окружающего абзаца в контексте, с точным якорем, который вы отметили, показанным в «...».

• Вернитесь к книге — извлеките свои выделения, сгруппируйте их по темам и процитируйте их себе.

• Размышляйте о своем чтении — закономерности в книгах, повторяющиеся идеи в ваших выделениях, то, к чему вас на самом деле тянет.

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

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

Related MCP server: Co-Reading MCP

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

Коллекции

Книги

Статус чтения

Аннотации

Статистика библиотеки

Содержимое книг

Работает только для EPUB без DRM (импортированные книги, Project Gutenberg, Standard Ebooks и т.д.). Покупки в Apple Books Store защищены FairPlay и возвращают понятную ошибку. Книги только из iCloud возвращают подсказку "не загружено".

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

Прикрепляемые объекты данных, доступные из выбора ресурсов Claude Desktop.

Доступные подсказки (Prompts)

Рабочие процессы в один клик, доступные из выбора подсказок Claude Desktop.

Установка

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

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

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

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

pip install apple-books-mcp

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

python -m apple_books_mcp

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

docker run -v ~/Library/Containers/com.apple.iBooksX/Data/Documents:/root/Library/Containers/com.apple.iBooksX/Data/Documents:ro ghcr.io/vgnshiyer/apple-books-mcp:latest

Запрос разрешения при первом запуске (macOS)

При первом использовании macOS спросит, может ли uvx (или python / docker, в зависимости от того, как вы запустили) "получать доступ к данным из других приложений". Нажмите Разрешить — MCP читает частный контейнер Apple Books по адресу ~/Library/Containers/com.apple.iBooksX/, который macOS рассматривает как изолированные данные другого приложения. Доступ осуществляется только для чтения и ограничен этим контейнером; сервер в любом случае запускается успешно, но без разрешения все инструменты будут возвращать пустые результаты.

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

Настройка Claude Desktop

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

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

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

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

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

{
    "mcpServers": {
        "apple-books-mcp": {
            "command": "docker",
            "args": [
                "run", "-i", "--rm",
                "-v", "~/Library/Containers/com.apple.iBooksX/Data/Documents:/root/Library/Containers/com.apple.iBooksX/Data/Documents:ro",
                "ghcr.io/vgnshiyer/apple-books-mcp:latest"
            ]
        }
    }
}

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

• [ ] Доступ к содержимому PDF (сейчас только EPUB)

• [ ] Более полный контекст аннотаций через разрешение CFI → абзац

Вклад

Спасибо, что рассматриваете возможность внесения вклада в этот проект!

Разработка

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

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

uv venv
uv sync

Отладка

С Claude Desktop

{
    "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

Открытие проблем (Issues)

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

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

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

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

Внесение вклада

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

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

Лицензия

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