Apple Books MCP

适用于Apple Books的模型上下文协议（MCP）服务器。

快速概览

• 让Claude总结您最近的亮点
• 让Claude按类型整理您的图书馆中的书籍
• 让Claude根据您的阅读历史推荐相似的书籍
• 让Claude比较同一主题下不同书籍的笔记

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

还有很多更多！

可用工具

工具	描述	参数
list_collections()	列出所有集合	无
get_collection_books(collection_id)	获取集合中的所有书籍	collection_id: str
describe_collection(collection_id)	获取集合的详细信息	collection_id: str
list_all_books()	列出所有书籍	无
get_book_annotations(book_id)	获取书籍的所有注释	book_id: str
describe_book(book_id)	获取特定书籍的详细信息	book_id: str
list_all_annotations()	列出所有注释	无
get_highlights_by_color(color)	按颜色获取所有高亮	color: str
search_highlighted_text(text)	按高亮文本搜索	text: str
search_notes(note)	搜索笔记	note: str
full_text_search(text)	搜索包含给定文本的注释	text: str
recent_annotations()	获取最新的10个注释	无
describe_annotation(annotation_id)	获取注释的详细信息	annotation_id: str

安装

使用uv（推荐）

uvx 可以直接运行 apple-books-mcp（无需安装）。

brew install uv  # 适用于macOS
uvx apple-books-mcp

使用pip

pip install apple-books-mcp

安装后，可以使用以下命令运行服务器：

python -m apple_books_mcp

配置

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支持
• 添加资源支持
• 编辑集合支持
• 编辑高亮支持

贡献

感谢您考虑为这个项目做出贡献！

开发

如果您克隆了此仓库，可以使用以下配置通过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"
            ]
        }
    }
}

使用inspector

npx @modelcontextprotocol/inspector uvx apple-books-mcp

提交问题

如果您遇到错误、有功能请求或想讨论与项目相关的内容，请在GitHub仓库中打开一个issue。当提交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文件。