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.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Der Apple Books MCP-Server schließt die Lücke zwischen Ihrer persönlichen Lesereise und den KI-Funktionen, indem er statische Büchersammlungen in interaktive Wissensspeicher umwandelt.

Related MCP Servers

macOS Defaults MCP Server
g0t4
A
security
F
license
A
quality
MCP server that enables reading and writing macOS system preferences and application settings through the defaults system.
Last updated -
4
11
Python
mcp-open-library
8enSmith
A
security
A
license
A
quality
A Model Context Protocol (MCP) server for the Open Library API that enables AI assistants to search for book information.
Last updated -
1
9
26
TypeScript
MIT License
Notes MCP
krasun
-
security
A
license
-
quality
An MCP server that enables AI assistants like Claude to access and manipulate Apple Notes on macOS, allowing for retrieving, creating, and managing notes through natural language interactions.
Last updated -
73
TypeScript
MIT License
Aladin Book Search MCP Server
TeeDDub
A
security
F
license
A
quality
MCP server that allows searching and retrieving book information from Aladin's book store API, including book details, bestseller lists, and category-based searches.
Last updated -
9
3
JavaScript

View all related MCP servers

apple-books-mcp