pear-apple

核心用法

Pear 是一套面向 Apple iCloud 生态的 MCP 技能集，通过 27 个工具实现对 Calendar、Reminders、Contacts 三大核心 PIM（个人信息管理）服务的完整读写访问。所有工具以 pear_ 为前缀，底层通过标准 CalDAV/CardDAV 协议与 iCloud 通信，而非依赖 Apple 私有 API。

主要功能模块包括：

• 日历管理（8 工具）：列表查询、事件搜索、创建/更新/删除、空闲时段查找、可用性检查
• 提醒事项（4 工具）：列表查询、创建/更新/完成，支持优先级和截止日期
• 联系人管理（9 工具）：完整 vCard 支持、分组管理、照片更新、批量操作
• 智能简报（1 工具）：一键获取当日事件与待办，自动关联联系人信息
• AI 排程（1 工具）：基于工作时段、时间偏好、缓冲期等维度智能推荐最优会议时间
• 批量操作（4 工具）：单次最多处理 50 条记录，内置速率限制保护

使用时需配置 PEAR_API_KEY，并在 Pear 官网绑定 iCloud 账户（需 Apple app-specific password）。所有日期时间采用 ISO 8601 格式，支持 IANA 时区。

显著优点

1. 跨平台兼容性：基于开放标准协议（CalDAV/CardDAV），可在任何支持 MCP 的平台上使用，不限于 macOS/iOS
2. 功能覆盖全面：27 个工具覆盖日常 PIM 管理的绝大多数场景，从简单查看到 AI 智能排程
3. 批量效率：支持单次 50 条记录的批量创建/删除，适合数据迁移或会议批量安排
4. 智能增强：pear_find_best_time 引入 AI 评分机制，综合考虑工作时段、时间偏好、缓冲期等因素，优于简单的空闲时段查询
5. 数据安全设计：更新操作采用合并而非覆盖策略；删除操作强制要求确认；支持幂等性键防止重复创建
6. 开发者体验：详尽的文档、错误码说明、常见模式示例，降低集成门槛

潜在缺点与局限性

1. 协议限制：CalDAV/CardDAV 为较旧标准，不支持 Apple Reminders 的现代功能（子任务、标签、智能列表、基于位置的提醒）
2. 服务依赖：完全依赖第三方 Pear 服务（pearmcp.com），若服务中断或变更政策将直接影响可用性
3. 网络要求：必须能访问 pearmcp.com，企业内网或受限网络环境可能无法使用
4. 非官方方案：非 Apple 官方集成，存在长期维护不确定性
5. 功能边界：明确不支持 Apple Notes、Mail、iMessage、iCloud Drive 等其他服务
6. 生日日历为合成特性：通过联系人生日字段生成的虚拟事件，非原生 Apple Birthdays 日历

适合的目标群体

• 跨平台 Apple 用户：需要在 Windows/Linux 或 Web 端管理 iCloud 日历/提醒/联系人的用户
• 效率工具集成者：希望将 iCloud PIM 数据接入 AI 助手、自动化工作流或自定义客户端的开发者
• 团队协作者：需要批量安排会议、查找共同空闲时段、管理联系人分组的职场人士
• 数据迁移需求者：需要从其他日历系统批量导入事件或联系人的用户
• 语音/AI 交互偏好者：希望通过自然语言管理日程，而非手动操作原生应用的用户

使用风险

1. 第三方服务风险：Pear 作为中间服务，理论上可访问用户的完整 iCloud PIM 数据，需信任其隐私政策和安全措施
2. API 密钥泄露：PEAR_API_KEY 为访问凭证，若泄露可能导致数据被未授权访问，应妥善保管避免硬编码
3. Apple 账户安全：需生成 app-specific password，虽限制权限但仍建议定期轮换
4. 批量操作不可逆：批量删除联系人等操作一旦确认执行，恢复依赖 iCloud 自身备份机制
5. 服务稳定性：依赖 pearmcp.com 的可用性和响应速度，高峰期可能存在延迟
6. 协议同步延迟：CalDAV/CardDAV 同步存在固有延迟，极端情况下可能出现数据不一致