1. 模型概述
MCP Server Apple Shortcuts 是一个基于 Model Context Protocol (MCP) 的服务器,它像一个安全翻译官,在AI助手(如Claude)和你macOS上的苹果“快捷指令”应用之间架起一座桥梁。简单来说,它允许你用自然语言命令AI,去触发和执行你预先在“快捷指令”App里设置好的各种自动化任务。
1.1 能力评估
这个模型本身不直接提供AI能力,而是扩展了AI助手的能力边界,使其能操作你的本地系统。其主要能力非常聚焦:
| 核心能力 | 具体描述 | 实现方式 |
|---|---|---|
| 浏览快捷指令库 | AI可以列出你Mac上所有已安装的“快捷指令”,方便你查询和选择。 | 通过MCP协议提供list_shortcuts工具。 |
| 触发快捷指令 | AI可以根据你提供的名称,运行指定的“快捷指令”,并可按需传递输入参数。 | 通过MCP协议提供run_shortcut工具。 |
| 安全管控 | 所有操作均在用户授权和控制下进行,AI无法自行决定或绕过权限执行指令。 | 通过MCP协议的安全框架和本地执行环境保障。 |
接口与参数:其核心就是上述两个主要“工具”(Tools),结构清晰。它没有复杂的模型参数,更像一个功能明确的协议适配器。
1.2 技术特点介绍
-
协议标准化:基于Anthropic开源的MCP协议,该协议旨在成为AI应用的“USB-C端口”,提供统一的连接标准。这使得该服务器能与任何兼容MCP的客户端(如Claude Desktop, Cursor)无缝协作。
-
安全沙箱:它本身不执行业务逻辑,所有自动化操作都由系统原生的“快捷指令”应用完成。AI仅负责“告知”和“触发”,确保了操作的安全性和可控性。
-
轻量集成:服务器本身轻量,专注于协议转换。复杂的自动化流程设计工作仍由用户通过图形化的“快捷指令”App完成,降低了使用门槛。
1.3 应用场景
此项目非常适合那些已经在使用macOS“快捷指令”自动化,并希望用更自然、智能的方式触发它们的用户。
-
个人效率助手:早晨用一句话启动“早安模式”(打开灯光、播放新闻、朗读日程)。
-
信息快速获取:让AI运行“获取每日单词”或“汇总未读邮件摘要”的快捷指令。
-
媒体与设备控制:语音或文字控制播放音乐、调整系统设置。
-
工作流衔接:在AI协助编写文案后,自动触发“压缩图片并上传至云盘”的后续流程。
注意区分:搜索结果中提到了另一个相关但不同的项目 “Applescript MCP”。两者核心区别在于:
本项目:专注于触发现有的“快捷指令”,依赖“快捷指令”App的图形化构建能力。
Applescript MCP:允许AI直接编写和执行AppleScript代码,能力更底层、更强大,但需要一定的脚本编写能力。
2. 安装与部署方式
该服务器仅支持macOS系统,因为它深度依赖系统内置的“快捷指令”应用。
2.1 前置条件准备
-
操作系统:确保运行的是较新版本的macOS(通常10.15 Catalina及以上)。
-
Node.js环境:需要安装Node.js 18或更高版本。建议通过官网或Homebrew安装。
# 使用Homebrew安装示例 brew install node@18
-
Claude Desktop:这是目前最主流的MCP客户端。从Anthropic官网下载并安装。
-
苹果“快捷指令”应用:确保该应用已安装并可正常运行。可在“应用程序”文件夹中查找或通过App Store获取。
2.2 服务器部署与客户端配置
核心步骤是配置Claude Desktop,使其连接到该MCP服务器。 服务器本身通常无需单独运行,由客户端按需启动。
-
定位Claude Desktop配置目录。
-
打开Claude Desktop应用。
-
在菜单栏点击
Claude Desktop->Settings->Developer。 -
找到并点击
Open config folder。这会在Finder中打开一个名为claude_desktop_config的文件夹。
-
-
创建MCP配置文件。
-
在该文件夹内,创建一个新文件,命名为
mcp.json。 -
将以下配置代码粘贴到文件中:
{ "mcpServers": { "apple-shortcuts": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-apple-shortcuts" ] } } }
说明:此配置告诉Claude Desktop,当需要时,使用
npx命令运行指定的MCP服务器包。 -
-
重启并验证。
-
完全关闭Claude Desktop应用,然后重新打开。
-
新建一个对话,尝试询问AI:“我有哪些可用的快捷指令?” 或 “请运行我的‘早晨问候’快捷指令”。
-
如果AI能够理解并回应相关操作,说明配置成功。
-
2.3 常见问题与修复
-
问题:AI回复“我不具备这个功能”或类似提示。
-
解决:首先确认Claude Desktop已重启。检查
mcp.json文件格式是否正确(无拼写错误,括号配对)。确保网络通畅,因为首次运行需要npx下载服务器包。
-
-
问题:AI可以列出指令,但执行失败。
-
解决:确认你要运行的“快捷指令”名称完全匹配。在macOS的“快捷指令”App中检查该指令是否能手动成功运行。
-
-
问题:权限错误。
-
解决:首次触发某个快捷指令时,系统可能会弹出权限请求(如“xxx想要访问你的日历”),务必点击允许。你可以在
系统设置 -> 隐私与安全性 -> 自动化中管理这些权限。
-
3. 配套客户端
-
客户端名称:Claude Desktop
-
是否付费:免费。Claude Desktop是Anthropic提供的官方免费桌面应用程序。
-
其他客户端:理论上任何支持MCP协议的客户端均可使用,例如高级代码编辑器 Cursor 也支持MCP。但对于大多数非开发者用户,Claude Desktop是最佳选择。
4. 案例讲解:打造你的AI早晨管家
假设你已经有一个名为“Morning Routine”的快捷指令,它能:1)播报天气,2)朗读今日日历事件,3)播放预设的晨间音乐列表。
目标:通过自然语言命令Claude来触发这个自动化流程。
步骤一:配置与连接
按照第2部分的步骤,完成MCP Server Apple Shortcuts的部署。
步骤二:与AI对话
直接在Claude Desktop的聊天窗口中输入:
“请帮我运行‘Morning Routine’快捷指令。”
步骤三:AI执行与反馈
-
Claude收到指令后,会通过MCP服务器调用
run_shortcut工具。 -
你的Mac会开始自动执行“Morning Routine”快捷指令,依次完成播报天气、朗读日程等操作。
-
Claude会在对话中回复你:“已为你触发‘Morning Routine’快捷指令。”
底层交互逻辑(模拟):
// 1. 你发送用户请求 用户: “请帮我运行‘Morning Routine’快捷指令。” // 2. Claude理解后,通过MCP向服务器发送请求 { "tool": "run_shortcut", "parameters": { "name": "Morning Routine" } } // 3. MCP服务器将请求转发给macOS系统执行 // 4. 执行完成后,Claude将结果返回给你 AI: “已为你触发‘Morning Routine’快捷指令。”
整个过程你无需触碰键盘或鼠标,只需一句话,AI便协调本地系统完成了系列任务。
5. 使用成本与商业价值
使用成本
-
金钱成本:零。项目本身开源免费,依赖的Claude Desktop和Node.js均免费。
-
时间成本:很低。主要花费在初次配置(约15-30分钟)和设计你的“快捷指令”上。一旦配置完成,使用门槛极低。
-
学习成本:低到中等。用户需要学习如何使用macOS“快捷指令”App创建自动化流程,这有一定的学习曲线,但其图形化界面比编程友好得多。使用AI触发环节则非常简单。
商业价值评估
-
个人用户价值:将自然语言交互与系统级自动化结合,大幅提升了个人工作效率和数字生活体验。它让不擅长编程的用户也能享受AI自动化的便利。
-
开发者/企业价值:本项目作为一个典型案例,展示了如何利用MCP协议安全、轻量地将AI能力注入到具体业务场景(这里是桌面自动化)。其范式可以被借鉴,用于构建连接内部系统(如CRM、数据库)的MCP服务器,实现AI驱动的工作流自动化,从而减少重复劳动、加速流程。
-
生态价值:它丰富了MCP生态,证明了MCP在连接AI与终端用户本地应用方面的可行性和实用性。虽然项目本身功能聚焦,但其“AI为大脑,本地应用为手脚”的模式具有启发意义。
总结:MCP Server Apple Shortcuts是一个精悍、实用、安全的桥梁型工具。它并非全能,但在其划定的赛道内——通过AI语音或文字触发macOS快捷指令——做得足够出色。对于Mac用户,尤其是“快捷指令”的爱好者,它是值得尝试的效率倍增器。它的更大意义在于,为普通人提供了一条低门槛体验AI Agent如何与真实世界交互的路径。

关注 “悠AI” 更多干货技巧行业动态