🚀 苹果 MCP 工具
苹果 MCP 工具是一个专为 MCP 协议 打造的苹果原生工具集合，能帮助用户在苹果设备上实现多样化的自动化操作，提升工作和生活效率。
关于如何设置和演示的分步视频，请参阅：https://x.com/DhravyaShah/status/1892694077679763671
以下是复制的 JSON 代码
{
"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，可以按照以下步骤手动安装：
- 克隆仓库：
git clone https://github.com/Dhravya/apple-mcp.git cd apple-mcp - 安装依赖项：
npm install - 启动服务：
node index.js
✨ 主要特性
-
消息：
- 使用 Apple Messages 应用发送消息
- 朗读消息内容
-
笔记：
- 列出所有笔记
- 在 Apple Notes 应用中搜索并阅读笔记
-
联系人：
- 搜索联系人以发送消息
-
邮件：
- 使用多个收件人（to, cc, bcc）和文件附件发送邮件
- 使用自定义查询、邮箱选择和结果限制来搜索邮件
- 设置未来时间的计划邮件
- 列出并管理已安排的邮件
- 检查全局或按邮箱的未读邮件数量
-
提醒事项：
- 列出所有提醒事项和提醒列表
- 搜索包含特定文本的提醒事项
- 创建新的提醒事项，可选截止日期和备注
- 在 Reminders 应用中打开以查看具体提醒事项
-
日历：
- 使用自定义日期范围搜索日历事件
- 列出即将进行的活动
- 创建新日历事件，包含标题、地点和备注等详细信息
- 在 Calendar 应用中打开特定的日历事件
-
网页搜索：
- 使用 DuckDuckGo 搜索网络
- 获取并处理来自搜索结果的内容
-
地图：
- 搜索位置和地址
- 将位置保存为 favorites
- 获取两点之间的路线指引
- 在地图上放置路标
- 创建、列出指南
- 将地点添加到指南中
-
待办：在 Apple Photos 应用中搜索包含特定文本的提醒事项
-
待办：在 Apple Photos 应用中搜索位置和照片
💻 使用示例
基础用法
安装完成后，您可以通过配置 MCP 代理来使用这些功能。具体步骤如下：
- 配置 MCP 代理以指向您的 Apple 设备。
- 在您的 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 设备已正确配置并连接到网络。
- 安装和使用过程中请遵守相关法律法规，尊重用户隐私。
希望这些工具能为您的自动化流程增添便利！