Apple Shortcuts

Apple Shortcuts MCP

用于 macOS 上 Apple Shortcuts 的 MCP 服务。

提供快捷指令的发现、查看和执行功能。支持使用结构化输入运行快捷指令，并处理输出。

适用场景

• 通过 Agent 触发现有的 Apple Shortcuts
• 无需通过 Shell 编排的本地自动化
• 适用于比一体化服务范围更小的场景

功能

• 列出快捷指令和文件夹
• 查看快捷指令详情
• 运行快捷指令并处理输入和输出
• 为上下文受限的客户端提供工具发现辅助功能 search_tools 和 get_tool_info
• 快捷指令资源和执行提示词
• 健康状态和状态检查：shortcuts_health、shortcuts_permission_guide、shortcuts_refresh_state

在这台 Mac 上安装

uvx apple-shortcuts-mcp

git clone https://github.com/JonathanRReed/Apple-MCPs.git
cd Apple-MCPs
uv sync --all-packages

在 AI Agent 中安装

{
  "mcpServers": {
    "apple-shortcuts": {
      "command": "uvx",
      "args": ["apple-shortcuts-mcp"],
      "env": {
        "APPLE_SHORTCUTS_MCP_SAFETY_MODE": "full_access"
      }
    }
  }
}

claude mcp add --transport stdio --scope user apple-shortcuts -- uvx apple-shortcuts-mcp

传输方式

stdio 是默认且推荐的传输方式。设置 APPLE_SHORTCUTS_MCP_TRANSPORT=streamable-http（可选设置 APPLE_SHORTCUTS_MCP_HOST 和 APPLE_SHORTCUTS_MCP_PORT）即可改为提供 Streamable HTTP 服务。

macOS 要求

• 必须能够使用内置的 shortcuts 命令行工具

启动检查清单

• 将 uvx apple-shortcuts-mcp（或克隆仓库中的 AppleShortcuts-MCP/start.sh）添加到 MCP 客户端
• 重新加载或重新连接客户端，以便将 Shortcuts 工具集加载到上下文中
• 首先调用 shortcuts_health
• 如果无法使用该命令行工具，请调用 shortcuts_permission_guide
• 更改 Shortcuts 目录后，请调用 shortcuts_refresh_state

提示词说明

• tools/list 会返回完整的 Shortcuts 工具集。上下文受限的客户端可以先使用 search_tools，再通过 get_tool_info 获取所需的 Shortcuts 工具信息。
• 如果用户对快捷指令的描述比较模糊，请先列出可用的快捷指令。
• 确认要运行哪个快捷指令后，再运行。

相关项目

• Apple-Tools-MCP