Shortcuts

shortcuts-mcp-server

一个 Model Context Protocol（MCP）服务，可访问 Apple Shortcuts 功能。此服务允许 AI 助手通过 MCP 接口列出、查看和运行你的快捷指令。

兼容 Cursor、Claude Desktop 和其他支持 MCP 的应用程序。

开始使用

前置条件

• macOS 14.5 或更高版本
• Xcode 26.0 或更高版本（Swift 6.2）
• mise

使用 mise 进行设置

安装 mise：

brew install mise

如需了解更多关于 mise 的信息，请访问官方文档。

快速安装

手动安装

使用以下服务更新你的 MCP 配置：

{
  "mcpServers": {
    "shortcuts-mcp-server": {
      "command": "mise",
      "args": [
        "x",
        "ubi:artemnovichkov/shortcuts-mcp-server@latest",
        "--",
        "shortcuts-mcp-server"
      ]
    }
  }
}

Xcode 27 Agent 插件

仓库根目录是一个采用 Claude Code 风格的 Agent 插件，Xcode 27 可以导入：

.claude-plugin/
├── plugin.json
└── icon.svg

plugin.json 声明了 MCP 服务，以及包含自定义工具图标和标题的 _meta。

在 Xcode 中：设置 → 智能功能 → 插件 → 添加插件…，然后选择克隆后的仓库目录。

使用方法

只需让大模型运行某个快捷指令、显示已添加快捷指令的列表，或在 Shortcuts 应用中查看快捷指令。

如果你的 MCP 客户端支持提示词和资源，也可以查看：

工具

• run - 运行快捷指令。
  • name - 要运行的快捷指令名称（字符串，必填）
• list - 列出你的快捷指令。
  • show-identifiers - 是否显示快捷指令的标识符。（布尔值，可选）
• view - 在 Shortcuts 应用中查看快捷指令。
  • name - 要查看的快捷指令名称（字符串，必填）

资源

• list - 列出你的快捷指令。

提示词

• run - 运行快捷指令。
  • name - 要运行的快捷指令名称（字符串，必填）
• list - 列出你的快捷指令。
  • show-identifiers - 是否显示快捷指令的标识符。（布尔值，可选）
• view - 在 Shortcuts 应用中查看快捷指令。
  • name - 要查看的快捷指令名称（字符串，必填）

参考资料

• 从命令行运行快捷指令
• 快捷指令相关实用链接列表
• Shortcuts 快捷指令库
• Shortcuts Directory