Apple Native Tools

🚀 苹果 MCP 工具

苹果 MCP 工具是一个专为 MCP 协议 打造的苹果原生工具集合，能帮助用户在苹果设备上实现多样化的自动化操作，提升工作和生活效率。

关于如何设置和演示的分步视频，请参阅：https://x.com/DhravyaShah/status/1892694077679763671

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

🚀 快速开始

📦 安装指南

自动安装

通过 Smithery 自动安装 Apple MCP for Claude Desktop：

npx -y @smithery/cli@latest install @Dhravya/apple-mcp --client claude

以及用于 cursor：

npx -y @smithery/cli@latest install @Dhravya/apple-mcp --client cursor

手动安装

如果不想使用 Smithery，可以按照以下步骤手动安装：

1. 克隆仓库：

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

2. 安装依赖项：

   npm install
   

3. 启动服务：

   node index.js
   

✨ 主要特性

• 消息：

  • 使用 Apple Messages 应用发送消息
  • 朗读消息内容

• 笔记：

  • 列出所有笔记
  • 在 Apple Notes 应用中搜索并阅读笔记

• 联系人：

  • 搜索联系人以发送消息

• 邮件：

  • 使用多个收件人（to, cc, bcc）和文件附件发送邮件
  • 使用自定义查询、邮箱选择和结果限制来搜索邮件
  • 设置未来时间的计划邮件
  • 列出并管理已安排的邮件
  • 检查全局或按邮箱的未读邮件数量

• 提醒事项：

  • 列出所有提醒事项和提醒列表
  • 搜索包含特定文本的提醒事项
  • 创建新的提醒事项，可选截止日期和备注
  • 在 Reminders 应用中打开以查看具体提醒事项

• 日历：

  • 使用自定义日期范围搜索日历事件
  • 列出即将进行的活动
  • 创建新日历事件，包含标题、地点和备注等详细信息
  • 在 Calendar 应用中打开特定的日历事件

• 网页搜索：

  • 使用 DuckDuckGo 搜索网络
  • 获取并处理来自搜索结果的内容

• 地图：

  • 搜索位置和地址
  • 将位置保存为 favorites
  • 获取两点之间的路线指引
  • 在地图上放置路标
  • 创建、列出指南
  • 将地点添加到指南中

• 待办：在 Apple Photos 应用中搜索包含特定文本的提醒事项

• 待办：在 Apple Photos 应用中搜索位置和照片

💻 使用示例

基础用法

安装完成后，您可以通过配置 MCP 代理来使用这些功能。具体步骤如下：

1. 配置 MCP 代理以指向您的 Apple 设备。
2. 在您的 AI 模型中设置相应的 API 调用。

例如，在 Claude 中，您可以这样配置：

{
  "providing": {
    "apple-mcp": {
      "url": "http://localhost:3000"
    }
  }
}

然后，您就可以在对话中使用以下功能：

• /apple/mcp/send-message：发送消息。
• /apple/mcp/read-message：朗读消息。
• /apple/mcp/search-notes：搜索笔记。

高级用法

发送一条消息给 John：

/apple/mcp/send-message to=John message="Hello, how are you?"

搜索包含“会议”的笔记：

/apple/mcp/search-notes query="会议"

设置一个提醒事项：

/apple/mcp/create-reminder title="开会" date="2023-10-05 14:00"

⚠️ 重要提示

• 确保您的 Apple 设备已正确配置并连接到网络。
• 安装和使用过程中请遵守相关法律法规，尊重用户隐私。

希望这些工具能为您的自动化流程增添便利！