返回 MCP 目录
public公开dns本地运行

apple-books-mcp

Apple Books MCP是一个为Apple Books设计的模型上下文协议服务器,提供书籍管理、标注查询和智能分析功能。

article

README

🚀 Apple Books MCP 服务器

Apple Books MCP 服务器借助 Claude 为用户提供书籍管理和阅读辅助功能,能总结亮点、整理书籍、推荐书籍以及比较笔记等,极大提升阅读体验。

🚀 快速开始

Apple Books MCP 服务器为你提供了一系列强大的书籍管理和阅读辅助功能:

  • 让Claude总结你最近的亮点
  • 让Claude帮你整理书架上的书籍按类别
  • 让Claude根据你的阅读历史推荐类似书籍
  • 让Claude比较同一主题下不同书籍的笔记

徽章 PyPI 许可证: Apache 2.0 请我喝咖啡

示例图片

以及其他更多功能!

✨ 主要特性

借助Claude的强大能力,实现书籍亮点总结、分类整理、个性化推荐和笔记比较等功能,为用户提供全方位的阅读支持。

📦 安装指南

使用pip安装

pip install apple-books-mcp

📚 详细文档

可用工具

| 属性 | 详情 | |------|------| | 工具 | 描述 | | 参数 | 具体要求 |

| 工具 | 描述 | 参数 | |----------|-------------|------------| | 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 |

配置

示例配置文件

# config.py
class AppleBooksConfig:
    def __init__(self):
        self.server_url = "http://localhost:8000"
        self.api_key = "your_api_key_here"

🤝 贡献指南

  1. Fork 本仓库到你的账户: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 文件。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端