AI导哈

macOS自动化工具

Apple MCP - Performance Edition是一款macOS自动化工具，通过AI控制Apple应用，性能提升126倍，适用于消息发送、笔记管理、联系人查询、邮件处理、提醒事项和日历事件等场景。

  • by dcpurnell
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 dcpurnell/apple-mcp

使用说明

🍎 苹果MCP-性能版⚡

macOS的自动化引擎 -用人工智能控制你的苹果应用程序，比以前快126倍！

这是一个增强型叉子 的原件 基于超级内存的苹果mcp 性能有了重大改进：

  • 🚀 日历速度提高126倍 -Python事件工具包（~238ms vs 30+秒）
  • ⚡ 快速联系人 -Python联系人框架（约1秒，包含完整细节）
  • 📊 优化提醒 -仅查询不完整的项目
  • 🔧 原生macOS框架 -更高的可靠性和速度

原始项目： 结账 超级存储器MCP 和那个 苹果mcp

这个叉子： https://github.com/dcpurnell/apple-mcp

这东西能做什么？

基本上，您希望Mac可以自动执行的所有操作（但从不费心设置）：

💬 消息 -因为谁有时间手动发短信？

  • 向联系人中的任何人发送消息（甚至是你一直在回避的那个人）
  • 阅读您的消息（最终赶上那些群聊）
  • 为以后安排消息（假装成有条理的人）

📝 备注 -你大脑的外部硬盘

  • 创建笔记的速度快于你忘记为什么需要它们
  • 搜索你称之为“有组织的笔记”的数字混乱
  • 找到你3个月前写下的绝妙想法

👥 联系人 -您的数字化个人网络⚡ Python联系人框架

  • 在联系人中查找任何人，而无需永远滚动
  • 立即获取完整的联系方式：电话、电子邮件、地址、笔记
  • 按姓名、电话、电子邮件或公司搜索（约1秒查询）
  • 实际使用你多年来建立的联系人数据库

📧 邮件 -像专业人士一样发电子邮件（或者至少假装）

  • 发送带附件的电子邮件、抄送、密送-全方位的专业服务
  • 以外科手术般的精准度搜索您的电子邮件混乱
  • 安排稍后的电子邮件（因为凌晨3点的想法不应该在凌晨3点发送）
  • 检查未读计数（为生存恐惧做好准备）

⏰ 提醒事项 -对于有人类记忆的人

  • 创建带有截止日期的提醒（最后记住要做的事情）
  • 搜索您的提醒墓地
  • 列出你一直拖延的所有事情
  • 打开特定的提醒（面对你的拖延）

📅 日历 -长期迟到者的时间管理(⚡ Python事件工具包-速度提高126倍！)

  • 创建活动的速度比你自己预订的速度快一倍
  • 搜索你肯定忘记的会议
  • 列出即将发生的事件（剧透：你可能会迟到）
  • 直接打开日历事件（跳过应用程序搜索）
  • 按特定日历筛选 （专注于重要的事情）
  • 默认21天窗口 （7天前，14天前-非常适合每周评论）
  • 闪电般快速的查询 （约238毫秒，而AppleScript为30+秒）

🗺️ 地图 - ⚠️ 当前已禁用

状态： 由于Apple Maps API限制而禁用。

为什么？ 与日历（EventKit）和联系人（Contacts框架）不同，Apple Maps没有本地编程API。之前的JXA/AppleScript实现不可靠，返回空结果，因为 selectedLocation() 方法不受一致支持。

未来计划： 考虑与其他地理编码服务（OpenStreetMap Nominim等）集成，或等待苹果提供合适的地图框架。

🎭 连锁命令的魔力

这就是它变辣的地方。你可以从字面上说：

阅读我的会议记录，为我遇到的人找到联系人，并向他们发送一条感谢信息

而且它只是。.. 作品。就像真正的魔法，但有更多的代码。

🚀 安装（简易方式）

选项1：史密瑟里（为老练的人）

npx -y install-mcp apple-mcp --client claude

对于Cursor用户（见）：

npx -y install-mcp apple-mcp --client cursor

选项2：手动设置（适用于Brave）

Click if you're feeling adventurous

首先，得到面包（如果你还没有）：

brew install oven-sh/bun/bun

然后将此添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "apple-mcp": {
      "command": "bunx",
      "args": ["--no-cache", "apple-mcp@latest"]
    }
  }
}

📦 日历和联系人功能需要Python框架

对于快速日历和联系人查询，请安装Python框架：

pip3 install pyobjc-framework-EventKit pyobjc-framework-Contacts

这使得：

  • ⚡ 日历：闪电般快速的操作（~238ms，而AppleScript为30+秒）
  • ⚡ 联系人：快速联系人搜索，提供完整详细信息（每次查询约1秒）

如果没有这些框架，日历和联系人功能仍然可以工作，但可能会慢得多。

⚙️ 配置（自定义默认值）

服务器使用 本地配置文件 这是非法的，所以你的个人信息永远不会被泄露。

🔧 快速设置

  1. 克隆存储库：

    git clone https://github.com/dcpurnell/apple-mcp.git
cd apple-mcp

  2. 复制示例配置并对其进行自定义：

    cp config.local.example.ts config.local.ts

  3. 编辑 config.local.ts 使用您的个人日历和电子邮件帐户名：

    export const DEFAULT_CALENDARS = [
  "Personal",      // Your calendar names from Calendar.app
  "Work",
  "Family",
  "Holidays"
];

export const DEFAULT_MAILBOXES = [
  "you@gmail.com",        // Your email accounts from Mail.app
  "work@company.com",
  "personal@icloud.com"
];

  4. 安装并运行：

    bun install
bun run index.ts

你的 config.local.ts 被忽视了 -它永远不会被提交或推送到GitHub。定制安全！

📅 查找日历名称

打开Calendar.app并查看侧边栏。使用您在那里看到的确切名称（区分大小写）。

📧 查找您的电子邮件帐户名

打开Mail.app并转到 邮件>设置>帐户。请严格按照所示使用帐户名。

🎬 在行动中看到它

以下是分步视频演练： https://x.com/DhravyaShah/status/1892694077679763671

（是的，它实际上和听起来一样酷）

🎯 会让你大吃一惊的命令示例

"Send a message to mom saying I'll be late for dinner"

"Find all my AI research notes and email them to sarah@company.com"

"Create a reminder to call the dentist tomorrow at 2pm"

"Show me my calendar for next week and create an event for coffee with Alex on Friday"

"Find the nearest pizza place and save it to my favorites"

🛠️ 地方发展（为工匠）

git clone https://github.com/dcpurnell/apple-mcp.git
cd apple-mcp
bun install

# Install Python dependencies for fast Calendar & Contacts
pip3 install pyobjc-framework-EventKit pyobjc-framework-Contacts

bun run index.ts

现在，让你的数字生活自动化吧！ 🚀

🙏 学分

原始项目： 基于超级内存的苹果mcp -由以下材料制成❤️ 通过 德拉维亚 还有超级内存团队（老实说，还有克劳德代码）

性能分叉： 增强通过 道格·珀内尔 使用Python原生框架，操作速度提高126倍

主要改进：

  • Python日历事件工具包（126倍加速）
  • Python联系人框架（~1s查询vs慢速AppleScript）
  • 优化提醒查询
  • 原生macOS框架集成

相关 MCP