Apple Books MCP

Apple Books 的模型上下文协议 (MCP) 服务器。

概览

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

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

还有更多！

可用工具

工具	描述	参数
list_collections()	列出所有合集	None
get_collection_books(collection_id)	获取合集中的所有书籍	collection_id: str
describe_collection(collection_id)	获取合集的详细信息	collection_id: str
list_all_books()	列出所有书籍	None
get_book_annotations(book_id)	获取书籍的所有注释	book_id: str
describe_book(book_id)	获取特定书籍的详细信息	book_id: str
list_all_annotations()	列出所有注释	None
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 条注释	None
describe_annotation(annotation_id)	获取注释的详细信息	annotation_id: str

安装

使用 uv (推荐)

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

brew install uv  # for 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" ]
        }
    }
}

使用 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

开启 Issues

如果您遇到错误、有功能请求或想讨论与项目相关的任何内容，请在 GitHub 存储库上开启一个 issue。 开启 issue 时，请提供：

Bug 报告: 详细描述问题。 如果可能，请包括重现错误的步骤，以及任何错误消息或屏幕截图。

功能请求: 清楚地解释您希望添加到项目中的新功能。 提供有关为什么此功能有益的背景信息。

一般讨论: 随时开始讨论与项目相关的更广泛的主题。

贡献

1️⃣ Fork 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 文件。