apple-swift-mcp

面向 Apple 应用的原生 Swift MCP 服务端。编译后的二进制文件内嵌 TCC 权限使用说明 — Calendar（日历）、Reminders（提醒事项）、Contacts（通讯录）和 Maps（地图）直接调用 EventKit / Contacts / MapKit 框架。Mail（邮件）、Messages（信息）、Notes（备忘录）仍通过 AppleScript 实现（因尚无公开框架支持），但改用进程内 NSAppleScript 执行，而非启动外部 osascript 进程。Photos（照片）则结合 PhotoKit（支持结构化搜索、相簿管理、收藏、导出/导入）与同一进程内的 AppleScript（用于读写标题/描述/关键词元数据及自由文本搜索）。

• GitHub: github.com/chrischall/apple-swift-mcp

安装

从 GitHub Releases 下载最新版 .mcpb 文件，双击即可在 Claude Desktop 中完成安装。首次运行时将提示请求 TCC 权限（日历、提醒事项、通讯录；若需读取 chat.db 则还需完整磁盘访问权限）。

要求运行于 macOS 14+ 系统且搭载 Apple Silicon 芯片。Intel 平台用户可自行从源码构建（执行 swift build -c release）。

工具

日历 / 提醒事项

• calendar — 列出、搜索、创建、更新、删除事件
• reminders — 列出提醒事项列表及其中条目；支持创建、标记完成、删除

通讯录 / 地图

• contacts — 支持按姓名、电话或邮箱搜索联系人
• maps — 获取路线导航、搜索附近地点

邮件 / 信息 / 备忘录（基于 AppleScript）

• mail — 支持搜索、阅读、发送、回复、转发邮件；采用 Messages.app 风格的会话线程组织方式
• messages — 发送 iMessage / SMS；通过直接查询 chat.db 获取历史记录；支持群组对话
• notes — 列出、搜索、阅读、创建备忘录

照片（PhotoKit + AppleScript）

• photos — 列出/搜索媒体资产与相簿、获取资产详情、收藏/整理/导入/导出、生成 JPEG 渲染图、设置标题/描述/关键词、执行自由文本搜索

环境变量

可选的用户配置（在 Claude Desktop → Settings → MCP 中设置）：

• APPLE_MCP_DEFAULT_CALENDAR — 创建事件时默认使用的日历名称
• APPLE_MCP_DEFAULT_REMINDER_LIST — 创建提醒事项时默认使用的提醒事项列表名称

备注

• 该二进制文件仅支持 arm64 架构，原因在于部分间接依赖的 MCP SDK 组件（如 swift-collections、swift-service-lifecycle）未声明对 x86_64 的支持。
• 基于 EventKit / Contacts / MapKit 的工具性能远超等效的 AppleScript 实现，速度快数个数量级。
• 信息（Messages）工具通过直接读取 chat.db 获取历史记录；发送消息则仍依赖 AppleScript。