Apple-Books-MCP

Apple Books MCP

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

Auf einen Blick

Bitten Sie Claude, Ihre jüngsten Highlights zusammenzufassen
Bitten Sie Claude, die Bücher in Ihrer Bibliothek nach Genre zu ordnen
Bitten Sie Claude, Ihnen basierend auf Ihrem Leseverlauf ähnliche Bücher zu empfehlen
Bitten Sie Claude, Notizen aus verschiedenen Büchern zum gleichen Thema zu vergleichen

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

Und vieles mehr!

Verfügbare Tools

Werkzeug	Beschreibung	Parameter
list_collections()	Alle Sammlungen auflisten	Keiner
get_collection_books(Sammlungs-ID)	Alle Bücher einer Sammlung abrufen	Sammlungs-ID: str
describe_collection(Sammlungs-ID)	Details einer Sammlung abrufen	Sammlungs-ID: str
liste_alle_bücher()	Alle Bücher auflisten	Keiner
get_book_annotations(Buch-ID)	Alle Anmerkungen zu einem Buch abrufen	book_id: str
Buch beschreiben(Buch-ID)	Details zu einem bestimmten Buch abrufen	book_id: str
list_all_annotations()	Alle Anmerkungen auflisten	Keiner
get_highlights_by_color(Farbe)	Alle Highlights nach Farbe abrufen	Farbe: str
search_highlighted_text(Text)	Suche nach Hervorhebungen anhand des hervorgehobenen Textes	Text: str
search_notes(Notiz)	Suchen nach Notizen	Hinweis: str
Volltextsuche (Text)	Suche nach Anmerkungen, die den angegebenen Text enthalten	Text: str
aktuelle_Anmerkungen()	Holen Sie sich die 10 neuesten Anmerkungen	Keiner
describe_annotation(Annotation-ID)	Details einer Anmerkung abrufen	annotation_id: str

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

Verwenden von pip

pip install apple-books-mcp

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

python -m apple_books_mcp

Konfiguration

Claude Desktop-Setup

Verwendung von uvx (empfohlen)

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

Python verwenden

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

Kommende Funktionen

[ ] Docker-Unterstützung hinzufügen
[ ] Unterstützung für Ressourcen hinzufügen
[ ] Unterstützung für das Bearbeiten von Sammlungen
[ ] Unterstützung für Bearbeitungshighlights

Beitrag

Vielen Dank, dass Sie erwägen, zu diesem Projekt beizutragen!

Entwicklung

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

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

uv venv
uv sync

Debuggen

Mit Claude Desktop

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

Mit Inspektor

npx @modelcontextprotocol/inspector uvx apple-books-mcp

Probleme beim Öffnen

Wenn Sie auf einen Fehler stoßen, einen Funktionswunsch haben oder etwas zum Projekt besprechen möchten, eröffnen Sie bitte ein Issue im GitHub-Repository. Geben Sie dabei bitte Folgendes an:

Fehlerberichte : Beschreiben Sie das Problem detailliert. Fügen Sie, wenn möglich, Schritte zur Reproduktion des Fehlers sowie Fehlermeldungen oder Screenshots bei.

Funktionsanfragen : Erläutern Sie klar und deutlich die neue Funktion, die Sie sich für das Projekt wünschen. Geben Sie den Kontext an, warum diese Funktion von Vorteil wäre.

Allgemeine Diskussionen : Sie können gerne Diskussionen zu allgemeineren Themen im Zusammenhang mit dem Projekt beginnen.

Beitragen

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

Bitte geben Sie einen eindeutigen 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 Datei LICENSE.

apple-books-mcp

Integrations