siri-shortcuts

🚀 Siri 快捷方式 MCP 服务器

本 MCP 服务器借助 Model Context Protocol (MCP)，让用户能够访问 macOS 上的 Siri 快捷方式功能。它支持列出、打开以及运行 Shortcuts 应用里的快捷方式，为用户带来便捷的操作体验。

✨ 主要特性

• 公开 所有 快捷方式，LLM 可调用 Shortcuts 应用中的全部可用功能。
• 可列出所有可用的快捷方式。
• 能在 Shortcuts 应用中打开快捷方式。
• 支持携带可选输入参数运行快捷方式。
• 会为每个可用快捷方式自动生成工具。

💻 使用示例

基础用法

1. list_shortcuts

此工具用于列出系统上所有可用的 Siri 快捷方式，无需输入参数，返回值为快捷方式名称数组。

{
  "shortcuts": [{ "name": "我的快捷方式 1" }, { "name": "我的快捷方式 2" }]
}

2. open_shortcut

该工具用于在 Shortcuts 应用中打开一个快捷方式，需要输入要打开的快捷方式名称。

• 输入：
  • name (字符串)：要打开的快捷方式名称

3. run_shortcut

此工具可携带可选输入运行快捷方式，需要输入要运行的快捷方式名称，以及可选的传递给快捷方式的文本或文件路径。

• 输入：
  • name (字符串)：要运行的快捷方式名称
  • input (字符串，可选)：传递给快捷方式的文本或文件路径

高级用法

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

• 工具名称：run_shortcut_[净化处理后的快捷方式名称]
• 描述：运行特定的快捷方式
• 输入：
  • input (字符串，可选)：传递给快捷方式的文本或文件路径

📚 详细文档

将以下内容添加到您的 Claude 配置中，即可与 Claude 结合使用本服务器：

{
  "mcpServers": {
    "siri-shortcuts": {
      "command": "npx",
      "args": ["mcp-server-siri-shortcuts"]
    }
  }
}

🔧 技术细节

• 运用 macOS 的 shortcuts 命令行工具。
• 对快捷方式名称进行净化处理，以符合工具命名规范。
• 支持文本输入和文件路径输入。
• 可返回快捷方式输出（若有）。
• 实现了标准 MCP 错误处理。