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 的模型上下文协议 (MCP) 服务器。
一目了然
- 请克劳德总结一下你最近的亮点
- 让 Claude 根据类型整理你图书馆里的书籍
- 让 Claude 根据您的阅读历史推荐类似的书籍
- 让克劳德比较一下同一主题的不同书籍的笔记
https://github.com/user-attachments/assets/77a5a29b-bfd7-4275-a4af-8d6c51a4527e
还有更多！
可用工具
| 工具 | 描述 | 参数 |
|---|---|---|
| 列表集合（） | 列出所有收藏 | 没有任何 |
| 获取收藏书籍（收藏 ID） | 获取集合中的所有书籍 | collection_id：字符串 |
| 描述集合（collection_id） | 获取集合的详细信息 | collection_id：字符串 |
| 列出所有书籍（） | 列出所有书籍 | 没有任何 |
| 获取书籍注释（book_id） | 获取一本书的所有注释 | book_id：字符串 |
| 描述书籍（书籍 ID） | 获取特定书籍的详细信息 | book_id：字符串 |
| 列出所有注释（） | 列出所有注释 | 没有任何 |
| 按颜色获取高光（颜色） | 按颜色获取所有突出显示 | 颜色：str |
| 搜索突出显示的文本（文本） | 通过突出显示的文本搜索突出显示 | 文本：str |
| 搜索笔记（笔记） | 搜索笔记 | 注意：str |
| 全文搜索（文本） | 搜索包含给定文本的注释 | 文本：str |
| 最近的注释（） | 获取最近 10 条注释 | 没有任何 |
| 描述注释（注释ID） | 获取注释的详细信息 | 注释ID：str |
安装
使用 uv（推荐）
uvx可用于直接运行 apple-books-mcp（无需安装）。
使用 pip
安装后，您可以使用以下命令运行服务器：
配置
Claude 桌面设置
使用 uvx（推荐）
使用python
即将推出的功能
- [ ] 添加 docker 支持
- [ ] 添加资源支持
- [ ] 编辑收藏集支持
- [ ] 编辑突出显示支持
贡献
感谢您考虑为该项目做出贡献！
发展
如果您克隆了此存储库，则可以使用以下配置的 Claude Desktop 对其进行测试：
使用uv venv创建虚拟环境并安装依赖项。
调试
使用 Claude Desktop
与检查员
开放性问题
如果您遇到错误、有功能请求或想讨论与项目相关的内容，请在 GitHub 代码库上提交一个问题。提交问题时，请提供以下信息：
错误报告：详细描述问题。请尽可能提供重现错误的步骤，并附上错误信息或截图。
功能需求：清晰地解释您希望在项目中添加的新功能，并说明此功能带来的好处。
一般讨论：欢迎就与项目相关的更广泛的话题展开讨论。
贡献
1️⃣ Fork GitHub 仓库https://github.com/vgnshiyer/apple-books-mcp
2️⃣ 为您的更改创建一个新分支（git checkout -b feature/my-new-feature）。
3️⃣ 进行更改并彻底测试。
4️⃣ 推送您的更改并向main打开一个 Pull 请求。
请提供清晰的标题和更改描述。
执照
Apple Books MCP 采用 Apache 2.0 许可证。详情请参阅 LICENSE 文件。
This server cannot be installed
Apple Books MCP 服务器通过将静态书籍集合转变为交互式知识库，弥合了您的个人阅读旅程和 AI 功能之间的差距。