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 錯誤處理。