
Siri Shortcuts MCP Server

Overview
基本能力
产品定位
该MCP服务器旨在通过MCP协议提供对macOS Siri快捷指令的访问和控制能力,使LLM能够调用快捷指令应用中的所有可用功能。
核心功能
- 暴露所有快捷指令,LLM可以调用快捷指令应用中的任何功能
- 列出所有可用的快捷指令
- 在快捷指令应用中打开指定的快捷指令
- 运行带有可选输入参数的快捷指令
- 为每个可用的快捷指令动态生成工具
适用场景
- 自动化工作流程
- 通过LLM控制macOS系统功能
- 快速访问和执行常用快捷指令
- 开发与快捷指令集成的应用程序
工具列表
基础工具
list_shortcuts
- 功能:列出系统上所有可用的Siri快捷指令
- 输入:无
-
输出:快捷指令名称数组
-
open_shortcut
- 功能:在快捷指令应用中打开指定的快捷指令
-
输入:
name
(字符串)- 要打开的快捷指令名称 -
run_shortcut
- 功能:运行带有可选输入的快捷指令
- 输入:
name
(字符串)- 要运行的快捷指令名称input
(字符串,可选)- 传递给快捷指令的文本输入或文件路径
动态工具
服务器会自动为每个可用的快捷指令生成工具,格式如下:
- 工具名称:run_shortcut_[sanitized_shortcut_name]
- 功能:运行特定的快捷指令
- 输入:
- input
(字符串,可选)- 传递给快捷指令的文本输入或文件路径
常见问题解答
- 该服务器支持哪些输入类型?
-
支持直接文本输入和基于文件的输入
-
如何处理快捷指令名称中的特殊字符?
-
服务器会对快捷指令名称进行清理以确保工具命名的兼容性
-
如何获取快捷指令的输出?
- 当快捷指令有输出时,服务器会返回输出结果
使用教程
使用依赖
需要安装以下依赖:
1. macOS系统
2. Node.js环境
3. macOS shortcuts
CLI命令
安装教程
- 确保已安装Node.js
-
通过npm安装服务器:
bash npm install -g mcp-server-siri-shortcuts
-
在Claude配置中添加:
json { "mcpServers": { "siri-shortcuts": { "command": "npx", "args": ["mcp-server-siri-shortcuts"] } } }
调试方式
-
运行服务器:
bash npx mcp-server-siri-shortcuts
-
检查快捷指令列表:
bash shortcuts list
-
测试运行快捷指令:
bash shortcuts run "My Shortcut"
许可证
None