Apple Books MCP

Model Context Protocol (MCP)-Server für Apple Books.

Auf einen Blick

• Dort weitermachen, wo Sie aufgehört haben — Claude sieht das Kapitel, in dem Sie sich befinden, sowie dessen Text und aktuelle Markierungen im Buch.

• Markierungen erweitern — erhalten Sie Erklärungen zum umgebenden Absatz im Kontext, wobei der genaue Anker, den Sie markiert haben, als «...» angezeigt wird.

• Ein Buch erneut besuchen — rufen Sie Ihre Markierungen ab, gruppieren Sie sie nach Themen und lassen Sie sich Ihre eigenen Zitate zurückgeben.

• Über Ihr Leseverhalten nachdenken — Muster über Bücher hinweg, wiederkehrende Ideen in Ihren Markierungen, wozu Sie sich tatsächlich hingezogen fühlen.

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

Und vieles mehr!

Related MCP server: Co-Reading MCP

Verfügbare Tools

Sammlungen

Bücher

Lesestatus

Anmerkungen

Bibliotheksstatistiken

Buchinhalt

Funktioniert nur für EPUBs ohne DRM (importierte Bücher, Project Gutenberg, Standard Ebooks, etc.). Käufe aus dem Apple Books Store sind durch FairPlay geschützt und geben einen klaren Fehler zurück. Bücher, die nur in iCloud vorhanden sind, geben einen Hinweis "nicht heruntergeladen" zurück.

Verfügbare Ressourcen

Anhängbare Datenobjekte, die über den Ressourcen-Auswähler von Claude Desktop zugänglich sind.

Verfügbare Prompts

Workflows mit einem Klick, zugänglich über den Prompt-Auswähler von Claude Desktop.

Installation

Verwendung von uv (empfohlen)

uvx kann verwendet werden, um apple-books-mcp direkt auszuführen (ohne es zu installieren).

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

Verwendung von pip

pip install apple-books-mcp

Nach der Installation können Sie den Server wie folgt ausführen:

python -m apple_books_mcp

Verwendung von 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

Berechtigungsabfrage beim ersten Start (macOS)

Bei der ersten Verwendung fragt macOS, ob uvx (oder python / docker, je nachdem, wie Sie gestartet haben) "auf Daten von anderen Apps zugreifen" darf. Klicken Sie auf Erlauben — der MCP liest den privaten Container von Apple Books unter ~/Library/Containers/com.apple.iBooksX/, den macOS als sandboxed Daten einer anderen App behandelt. Der Zugriff ist schreibgeschützt und auf diesen Container beschränkt; der Server startet in jedem Fall erfolgreich, aber ohne Berechtigung bleibt jedes Tool leer.

Konfiguration

Claude Desktop Einrichtung

Verwendung von uvx (empfohlen)

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

Verwendung von python

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

Verwendung von 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"
            ]
        }
    }
}

Kommende Funktionen

• [ ] PDF-Inhaltszugriff (derzeit nur EPUB)

• [ ] Vollständigerer Anmerkungskontext via CFI → Absatzauflösung

Beitrag leisten

Vielen Dank, dass Sie in Erwägung ziehen, zu diesem Projekt beizutragen!

Entwicklung

Wenn Sie dieses Repository geklont haben, können Sie es mit Claude Desktop unter Verwendung der folgenden Konfiguration testen:

Verwenden Sie uv venv, um eine virtuelle Umgebung zu erstellen und die Abhängigkeiten zu installieren.

uv venv
uv sync

Debugging

Mit Claude Desktop

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

Mit Inspector

npx @modelcontextprotocol/inspector uvx apple-books-mcp

Issues öffnen

Wenn Sie auf einen Fehler stoßen, einen Funktionswunsch haben oder etwas im Zusammenhang mit dem Projekt besprechen möchten, öffnen Sie bitte ein Issue im GitHub-Repository. Wenn Sie ein Issue öffnen, geben Sie bitte Folgendes an:

Fehlerberichte: Beschreiben Sie das Problem im Detail. Fügen Sie nach Möglichkeit Schritte zur Reproduktion des Fehlers sowie Fehlermeldungen oder Screenshots bei.

Funktionswünsche: Erklären Sie klar, welche neue Funktion Sie gerne zum Projekt hinzugefügt sehen würden. Geben Sie Kontext dazu, warum diese Funktion vorteilhaft wäre.

Allgemeine Diskussionen: Fühlen Sie sich frei, Diskussionen zu breiteren Themen im Zusammenhang mit dem Projekt zu starten.

Beitrag leisten

1️⃣ Forken Sie das GitHub-Repository https://github.com/vgnshiyer/apple-books-mcp
2️⃣ Erstellen Sie einen neuen Branch für Ihre Änderungen (git checkout -b feature/my-new-feature).
3️⃣ Nehmen Sie Ihre Änderungen vor und testen Sie diese gründlich.
4️⃣ Pushen Sie Ihre Änderungen und öffnen Sie einen Pull Request an main.

Bitte geben Sie einen klaren Titel und eine Beschreibung Ihrer Änderungen an.

Lizenz

Apple Books MCP ist unter der Apache 2.0 Lizenz lizenziert. Weitere Informationen finden Sie in der LICENSE-Datei.