vgnshiyer
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"apple-books-mcp": {
"args": [
"-m",
"apple_books_mcp"
],
"command": "python"
}
}
}服务介绍
Apple Books MCP
Apple Books 的 Model Context Protocol (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（无需安装）。
bash
brew install uv # 适用于 macOS
uvx apple-books-mcp
使用 pip
bash
pip install apple-books-mcp
安装后，可以使用以下命令运行服务器：
bash
python -m apple_books_mcp
配置
Claude Desktop 设置
使用 uvx（推荐）
json
{
"mcpServers": {
"apple-books-mcp": {
"command": "uvx",
"args": [ "apple-books-mcp@latest" ]
}
}
}
使用 python
json
{
"mcpServers": {
"apple-books-mcp": {
"command": "python",
"args": ["-m", "apple_books_mcp"]
}
}
}
即将推出的功能
- 添加 Docker 支持
- 添加资源支持
- 编辑集合支持
- 编辑高亮支持
贡献
感谢您考虑为本项目做出贡献！
开发
如果您克隆了此仓库，可以使用以下配置通过 Claude Desktop 进行测试：
使用 uv venv 创建虚拟环境并安装依赖项。
bash
uv venv
uv sync
调试
使用 Claude Desktop
json
{
"mcpServers": {
"apple-books-mcp": {
"command": "uv",
"args": [
"--directory",
"/path/to/apple-books-mcp/",
"run",
"apple_books_mcp",
"-v"
]
}
}
}
使用检查器
bash
npx @modelcontextprotocol/inspector uvx apple-books-mcp
提交问题
如果您遇到错误、有功能请求或想讨论与项目相关的内容，请在 GitHub 仓库中提交一个问题。提交问题时，请提供：Bug Reports: 请详细描述问题。如果可能的话，请附上重现该错误的步骤，以及任何错误信息或屏幕截图。
Feature Requests: 请清楚地说明您希望添加到项目中的新功能。提供此功能为何有益的背景信息。
General Discussions: 欢迎就与项目相关的更广泛主题展开讨论。
贡献
1️⃣ Fork GitHub 仓库 https://github.com/vgnshiyer/apple-books-mcp
2️⃣ 为您的更改创建一个新的分支（git checkout -b feature/my-new-feature）。
3️⃣ 进行您的更改并彻底测试它们。
4️⃣ 提交您的更改，并向 main 分支发起 Pull Request。
请提供清晰的标题和更改描述。
许可证
Apple Books MCP 采用 Apache 2.0 许可证。详情请参阅 LICENSE 文件。
