Siri Shortcuts MCP 服务器

该 MCP 服务器通过模型上下文协议（MCP）提供对 Siri 快捷指令功能的访问。它允许列出、打开和运行 macOS 快捷指令应用中的快捷指令。

功能

• 暴露 所有 快捷指令，这意味着 LLM 可以调用快捷指令应用中可用的任何内容。
• 列出所有可用的快捷指令
• 在快捷指令应用中打开快捷指令
• 运行带有可选输入参数的快捷指令
• 为每个可用的快捷指令动态生成工具

工具

基础工具

1. list_shortcuts

   • 列出系统上所有可用的 Siri 快捷指令
   • 无需输入
   • 返回：快捷指令名称数组

   {
     "shortcuts": [{ "name": "我的快捷指令 1" }, { "name": "我的快捷指令 2" }]
   }
   

2. open_shortcut

   • 在快捷指令应用中打开一个快捷指令
   • 输入：
     • name（字符串）：要打开的快捷指令名称

3. run_shortcut

   • 运行一个带有可选输入的快捷指令
   • 输入：
     • name（字符串）：要运行的快捷指令名称或标识符（UUID）
     • input（字符串，可选）：传递给快捷指令的文本输入或文件路径

动态工具

服务器会自动为每个可用的快捷指令生成额外的工具，格式如下：

• 工具名称：run_shortcut_[sanitized_shortcut_name]
• 描述：运行特定的快捷指令
• 输入：
  • input（字符串，可选）：传递给快捷指令的文本输入或文件路径

配置

服务器支持以下环境变量：

• GENERATE_SHORTCUT_TOOLS（默认：true）：当设置为 false 时，禁用动态快捷指令工具的生成。只有基础工具（list_shortcuts, open_shortcut, run_shortcut）可用。
• INJECT_SHORTCUT_LIST（默认：false）：当设置为 true 时，将可用快捷指令列表注入到 run_shortcut 工具描述中，以帮助 LLM 理解哪些快捷指令可用。

与 Claude 的使用

添加到你的 Claude 配置中：

{
  "mcpServers": {
    "siri-shortcuts": {
      "command": "npx",
      "args": ["mcp-server-siri-shortcuts"],
      "env": {
        "GENERATE_SHORTCUT_TOOLS": "true",
        "INJECT_SHORTCUT_LIST": "false"
      }
    }
  }
}

实现细节

• 底层使用 macOS 的 shortcuts CLI 命令
• 对快捷指令名称进行清理以确保工具命名的兼容性
• 支持直接文本输入和基于文件的输入
• 在可用时返回快捷指令的输出
• 实现了标准的 MCP 错误处理