项目简介

Apple Books MCP 是一个实现了 Model Context Protocol (MCP) 的服务器，旨在将大型语言模型 (LLM) 应用与您的 Apple Books 图书库数据连接起来。它允许LLM通过标准化的协议访问您的图书、藏书以及重要的阅读笔记和高亮内容，从而实现智能化的图书管理和阅读辅助功能。

主要功能点

该服务器通过提供一系列工具（Tools）来暴露对 Apple Books 数据的访问能力：

• 藏书列表与详情: 查看您所有的藏书列表，获取特定藏书的详细信息。
• 藏书内图书: 获取某个特定藏书中包含的所有图书列表。
• 图书列表与详情: 查看您的所有图书列表，获取特定图书的详细信息。
• 图书批注与高亮: 获取特定图书的所有批注和高亮内容。
• 所有批注列表: 列出您的Apple Books库中的所有批注和高亮。
• 按颜色查找高亮: 根据高亮颜色查找相关的批注。
• 搜索高亮文本: 在高亮文本内容中进行搜索。
• 搜索笔记内容: 在您添加的批注笔记中进行搜索。
• 全文搜索批注: 在批注包含的任意文本内容中进行搜索。
• 最新批注: 获取最近添加的10条批注。
• 批注详情: 获取特定批注的详细信息。

这些功能使LLM能够理解您的阅读历史和习惯，并基于此提供摘要、整理、推荐等服务。

安装步骤

您可以通过 'pip' 或 'uvx' 来安装和运行 Apple Books MCP 服务器。

使用 uvx (推荐):

首先安装 'uv' (如果未安装):

brew install uv  # 适用于 macOS
# 其他系统请参考 uv 官方文档

然后直接运行：

uvx apple-books-mcp

使用 pip:

安装 Apple Books MCP 包：

pip install apple-books-mcp

安装完成后，通过 Python 模块方式运行服务器：

python -m apple_books_mcp

服务器配置 (供 MCP 客户端使用)

Apple Books MCP 是一个服务器，需要一个支持 MCP 的客户端（例如 Claude Desktop）来连接和交互。客户端通常需要配置服务器的启动方式。

典型的客户端配置信息（例如在 JSON 格式的配置文件中）会包含以下关键信息：

• 一个唯一的服务器名称，例如 'apple-books-mcp'。
• 一个 'command' 字段，指定用于启动服务器的可执行程序路径（例如 'python' 或 'uvx'）。
• 一个 'args' 字段，这是一个字符串列表，包含传递给 'command' 的参数（例如 '["-m", "apple_books_mcp"]' 或 '["apple-books-mcp@latest"]'）。

您需要根据您的安装方式（pip 或 uvx）和客户端的要求，在客户端的MCP服务器配置中填入对应的 'command' 和 'args' 信息。

基本使用方法

服务器启动后，兼容的 MCP 客户端即可连接并与之通信。在客户端（例如支持工具调用的LLM界面）中，您可以像与LLM对话一样，提出与您的Apple Books数据相关的问题或指令，例如：

• “请列出我的所有藏书。”
• “总结一下我在最新阅读的一本书中的所有高亮。”
• “查找包含‘人工智能’这个词的所有笔记。”
• “根据我的阅读历史，推荐一些相似主题的书。”

LLM 客户端会通过 MCP 协议调用 Apple Books MCP 服务器提供的相应工具来获取所需信息，并将结果呈现给您或用于生成回复。