Apple Books MCP
Apple Books 的模型上下文协议 (MCP) 服务器。
一目了然
请克劳德总结一下你最近的亮点
让 Claude 根据类型整理你图书馆里的书籍
让 Claude 根据您的阅读历史推荐类似的书籍
让克劳德比较一下同一主题的不同书籍的笔记
https://github.com/user-attachments/assets/77a5a29b-bfd7-4275-a4af-8d6c51a4527e
还有更多!
Related MCP server: mcp-open-library
可用工具
工具 | 描述 | 参数 |
列表集合() | 列出所有收藏 | 没有任何 |
获取收藏书籍(收藏 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(无需安装)。
brew install uv # for macos
uvx apple-books-mcp使用 pip
pip install apple-books-mcp安装后,您可以使用以下命令运行服务器:
python -m apple_books_mcp配置
Claude 桌面设置
使用 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"
]
}
}
}与检查员
npx @modelcontextprotocol/inspector uvx apple-books-mcp开放性问题
如果您遇到错误、有功能请求或想讨论与项目相关的内容,请在 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
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.