Siri Shortcuts MCP Server

此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_[清理后的快捷方式名称]
• 描述：运行特定的快捷方式
• 输入：
  • 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错误处理