Apple Books MCP 服务器

“Apple Books” MCP 服务器的作用是什么？

Apple Books MCP（模型上下文协议）服务器是一款专为将 AI 助手与 Apple Books 生态系统连接而设计的工具，可无缝集成与书籍相关的数据和用户上下文到开发流程中。通过将收藏、书籍、批注和高亮内容以结构化资源方式公开，该 MCP 服务器赋能 AI 代理高效地组织、检索和分析用户图书馆。其工具支持诸如摘要高亮内容、按类别整理书籍、推荐类似读物、跨书籍对比笔记等任务。这一能力对于开发 AI 阅读助手、效率工具或受益于 Apple Books 数据直接可编程访问的教育应用尤为有价值。

提示模板列表

仓库中未提及明确的提示模板。

资源列表

仓库或 README 中未描述明确资源。

工具列表

• list_collections()
  列出用户 Apple Books 图书馆中的所有书籍收藏。

• get_collection_books(collection_id)
  获取指定收藏内的所有书籍。

• describe_collection(collection_id)
  提供某一具体收藏的详细信息。

• list_all_books()
  列出用户图书馆中的所有书籍。

• get_book_annotations(book_id)
  获取指定书籍的所有批注。

• describe_book(book_id)
  提供某一具体书籍的详细信息。

• list_all_annotations()
  列出所有书籍的全部批注。

• get_highlights_by_color(color)
  按颜色筛选并获取所有高亮内容。

• search_highlighted_text(text)
  通过高亮文本在图书馆内搜索高亮内容。

• search_notes(note)
  在图书馆内搜索笔记。

• full_text_search(text)
  检索包含指定文本的批注。

• recent_annotations()
  获取最近十条批注。

• describe_annotation(annotation_id)
  提供某一具体批注的详细信息。

该 MCP 服务器的应用场景

• 摘要最近高亮内容
  开发者可利用该服务器让 AI 助手摘要用户最近的高亮内容，帮助快速回顾和复习重要片段。

• 按类别整理书籍
  支持自动将用户图书按类别归类整理，方便导航和发现。

• 个性化图书推荐
  通过分析阅读历史和批注，服务器可驱动 AI 提供类似书籍或新类别的推荐。

• 跨书籍对比笔记
  便于对同一主题在不同书籍中的笔记进行对比，提升研究与学习效率。

• 批注搜索与管理
  支持对批注、高亮和笔记的高级搜索与管理，让用户更方便地查找和整理想法。

如何设置

Windsurf

1. 确保已安装 Node.js 和 Windsurf。
2. 找到你的 .windsurf/config.json 文件。
3. 将 Apple Books MCP 服务器配置添加到 mcpServers 部分，参考如下代码片段。
4. 保存文件并重启 Windsurf。
5. 在 Windsurf UI 中确认服务器已添加。

{
  "mcpServers": {
    "apple-books-mcp": {
      "command": "apple-books-mcp",
      "args": []
    }
  }
}

保护 API 密钥（如适用）：

{
  "mcpServers": {
    "apple-books-mcp": {
      "command": "apple-books-mcp",
      "args": [],
      "env": {
        "APPLE_BOOKS_API_KEY": "${APPLE_BOOKS_API_KEY}"
      },
      "inputs": {
        "api_key": "${APPLE_BOOKS_API_KEY}"
      }
    }
  }
}

Claude

1. 确保已安装并更新 Claude。
2. 打开 Claude 的配置文件（如 claude.json）。
3. 在 mcpServers 下添加 Apple Books MCP 服务器。
4. 保存并重启 Claude。
5. 在 Claude 控制面板中确认服务器可用。

{
  "mcpServers": {
    "apple-books-mcp": {
      "command": "apple-books-mcp",
      "args": []
    }
  }
}

保护 API 密钥：

{
  "mcpServers": {
    "apple-books-mcp": {
      "command": "apple-books-mcp",
      "args": [],
      "env": {
        "APPLE_BOOKS_API_KEY": "${APPLE_BOOKS_API_KEY}"
      },
      "inputs": {
        "api_key": "${APPLE_BOOKS_API_KEY}"
      }
    }
  }
}

Cursor

1. 安装 Node.js 和 Cursor。
2. 打开 cursor.json 配置文件。
3. 将 Apple Books MCP 服务器添加到 mcpServers 部分。
4. 保存更改后重启 Cursor。
5. 在 Cursor 界面检查集成情况。

{
  "mcpServers": {
    "apple-books-mcp": {
      "command": "apple-books-mcp",
      "args": []
    }
  }
}

保护 API 密钥：

{
  "mcpServers": {
    "apple-books-mcp": {
      "command": "apple-books-mcp",
      "args": [],
      "env": {
        "APPLE_BOOKS_API_KEY": "${APPLE_BOOKS_API_KEY}"
      },
      "inputs": {
        "api_key": "${APPLE_BOOKS_API_KEY}"
      }
    }
  }
}

Cline

1. 确保已安装 Node.js 和 Cline。
2. 编辑 cline.json 配置文件。
3. 在 mcpServers 部分插入 Apple Books MCP 服务器配置。
4. 保存并重启 Cline。
5. 在 Cline 中确认服务器可用性。

{
  "mcpServers": {
    "apple-books-mcp": {
      "command": "apple-books-mcp",
      "args": []
    }
  }
}

保护 API 密钥：

{
  "mcpServers": {
    "apple-books-mcp": {
      "command": "apple-books-mcp",
      "args": [],
      "env": {
        "APPLE_BOOKS_API_KEY": "${APPLE_BOOKS_API_KEY}"
      },
      "inputs": {
        "api_key": "${APPLE_BOOKS_API_KEY}"
      }
    }
  }
}

如何在流程中使用该 MCP

在 FlowHunt 中使用 MCP

要在 FlowHunt 的流程中集成 MCP 服务器，首先将 MCP 组件添加到你的流程并连接至 AI 代理：

点击 MCP 组件以打开配置面板。在系统 MCP 配置部分，按照如下 JSON 格式输入你的 MCP 服务器信息：

{
  "apple-books-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

配置完成后，AI 代理即可将该 MCP 作为工具，访问其全部功能和能力。请记得将 "apple-books-mcp" 替换为你实际的 MCP 服务器名称，并将 URL 替换为你自己的 MCP 服务器地址。

总览

综上，Apple Books MCP 服务器为书籍管理和批注任务提供了丰富的工具，但缺少提示模板、明确资源以及 roots 或采样等高级 MCP 功能的文档支持。其文档简明，API 面向实际开发者需求，适合 Apple Books 相关工作流的开发。

我们的看法

该 MCP 服务器评分为 6 分（满分 10 分）：拥有清晰的许可协议、实用的操作型工具和不错的文档，但缺乏高级 MCP 特性（如提示、资源、roots、采样），社区活跃度有限。

MCP 评分