Integrations
Provides tools for interacting with Apple Books, allowing access to book collections, detailed book information, and annotation management including highlights and notes.
Provides support for the developer through donation links to Buy Me A Coffee platform.
Facilitates contribution to the project through the GitHub repository, including issue reporting and pull request submission.
Apple Books MCP
Apple Books 用の Model Context Protocol (MCP) サーバー。
一目でわかる
- クロードに最近のハイライトをまとめてもらいましょう
- クロードにライブラリの本をジャンル別に整理してもらいましょう
- あなたの読書履歴に基づいて、クロードに似たような本を勧めてもらいましょう
- クロードに同じテーマで読んだ異なる本のノートを比較してもらいます
https://github.com/user-attachments/assets/77a5a29b-bfd7-4275-a4af-8d6c51a4527e
その他にも多数あります!
利用可能なツール
| 道具 | 説明 | パラメータ |
|---|---|---|
| list_collections() | すべてのコレクションを一覧表示する | なし |
| get_collection_books(コレクションID) | コレクション内のすべての書籍を取得する | コレクションID: 文字列 |
| コレクションの説明(コレクションID) | コレクションの詳細を取得する | コレクションID: 文字列 |
| すべての書籍をリストする() | すべての書籍を一覧表示する | なし |
| get_book_annotations(書籍ID) | 本のすべての注釈を取得する | book_id: 文字列 |
| 本の説明(書籍ID) | 特定の書籍の詳細を取得する | book_id: 文字列 |
| すべての注釈をリストする() | すべての注釈を一覧表示する | なし |
| get_highlights_by_color(色) | 色別にハイライトをすべて取得 | 色: str |
| search_highlighted_text(テキスト) | ハイライトされたテキストでハイライトを検索する | テキスト: 文字列 |
| search_notes(ノート) | メモを検索 | 注記: str |
| 全文検索(テキスト) | 指定されたテキストを含む注釈を検索する | テキスト: 文字列 |
| 最近の注釈() | 最新の注釈10件を取得する | なし |
| アノテーションの説明(アノテーションID) | 注釈の詳細を取得する | 注釈ID: 文字列 |
インストール
uvの使用（推奨）
uvx を使用すると、apple-books-mcp を直接実行できます (インストールせずに)。
pipの使用
インストール後、以下を使用してサーバーを実行できます。
構成
クロードデスクトップセットアップ
uvxの使用（推奨）
Pythonを使用する
今後の機能
- [ ] Dockerサポートを追加
- [ ] リソースサポートの追加
- [ ] コレクション編集のサポート
- [ ] ハイライト編集のサポート
貢献
このプロジェクトへの貢献をご検討いただきありがとうございます。
発達
このリポジトリをクローンした場合は、以下の構成で Claude Desktop を使用してテストできます。
uv venvを使用して仮想環境を作成し、依存関係をインストールします。
デバッグ
クロード・デスクトップ
検査官と
冒頭の問題
バグに遭遇した場合、機能リクエストがある場合、またはプロジェクトに関連する議論をしたい場合は、GitHubリポジトリでIssueを作成してください。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ファイルをご覧ください。
This server cannot be installed
Apple Books MCP サーバーは、静的な書籍コレクションをインタラクティブな知識リポジトリに変換することで、個人の読書体験と AI 機能の間のギャップを埋めます。