mcpField
S
Siri Shortcuts MCP Server

Siri Shortcuts MCP Server

本地服务
github.com/dvcrn生产力1957 周前更新

关于 Siri Shortcuts MCP Server

Siri Shortcuts MCP Server 让 LLM 通过 MCP 列出、打开和运行 macOS 快捷指令 App 中的快捷指令。适合希望在 Claude 等客户端中调用本地快捷指令的 macOS 用户。

主要功能

  1. 01列出系统中所有可用的快捷指令
  2. 02在快捷指令 App 中打开指定快捷指令
  3. 03运行快捷指令并可传入文本或文件路径作为输入
  4. 04为每个快捷指令动态生成独立工具
  5. 05通过环境变量控制动态工具与工具描述

适用场景

  1. 01让 LLM 在对话中触发 macOS 上已有的自动化流程
  2. 02通过自然语言查找并运行指定快捷指令
  3. 03将文本或文件交给快捷指令处理

MCP 相关

该项目是 MCP 服务端,向 MCP 客户端暴露 list_shortcuts、open_shortcut、run_shortcut 等基础工具,并为每个快捷指令生成对应工具。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"siri-shortcuts": {
"command": "npx",
"args": [
"-y",
"mcp-server-siri-shortcuts"
]
}
}
}
启动命令npx -y mcp-server-siri-shortcuts

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmmcp-server-siri-shortcuts

工具

3

收录的工具列表 · 更新于 3 周前

此工具无需参数。

详细介绍

Siri Shortcuts MCP Server

此 MCP 服务通过 Model Context Protocol(MCP)提供 Siri 快捷指令功能。它支持列出、打开和运行 macOS「快捷指令」应用中的快捷指令。

截图

功能

  • 暴露_所有_快捷指令,这意味着大模型可以调用「快捷指令」应用中提供的任何功能。
  • 列出所有可用的快捷指令
  • 在「快捷指令」应用中打开快捷指令
  • 运行快捷指令,并可选择传入输入参数
  • 为每个可用的快捷指令动态生成工具

工具

基础工具
  1. list_shortcuts

    • 列出系统中所有可用的 Siri 快捷指令
    • 无需输入
    • 返回:快捷指令名称数组
    {
      "shortcuts": [{ "name": "My Shortcut 1" }, { "name": "My Shortcut 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 工具的描述中,帮助大模型了解有哪些快捷指令可用。

与 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 错误处理

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。