Siri Shortcuts MCP Server

Siri Shortcuts MCP Server

site icon
2025.02.25 129
TypeScriptSiri快捷指令macOS自动化开发效率
该MCP服务器通过模型上下文协议(MCP)提供对Siri快捷指令功能的访问。它允许列出、打开和运行macOS快捷指令应用中的快捷指令。
View on GitHub

Overview

基本能力

产品定位

该MCP服务器旨在通过MCP协议提供对macOS Siri快捷指令的访问和控制能力,使LLM能够调用快捷指令应用中的所有可用功能。

核心功能

  • 暴露所有快捷指令,LLM可以调用快捷指令应用中的任何功能
  • 列出所有可用的快捷指令
  • 在快捷指令应用中打开指定的快捷指令
  • 运行带有可选输入参数的快捷指令
  • 为每个可用的快捷指令动态生成工具

适用场景

  • 自动化工作流程
  • 通过LLM控制macOS系统功能
  • 快速访问和执行常用快捷指令
  • 开发与快捷指令集成的应用程序

工具列表

基础工具

  1. list_shortcuts
  2. 功能:列出系统上所有可用的Siri快捷指令
  3. 输入:无
  4. 输出:快捷指令名称数组

  5. open_shortcut

  6. 功能:在快捷指令应用中打开指定的快捷指令
  7. 输入:name(字符串)- 要打开的快捷指令名称

  8. run_shortcut

  9. 功能:运行带有可选输入的快捷指令
  10. 输入:
    • name(字符串)- 要运行的快捷指令名称
    • input(字符串,可选)- 传递给快捷指令的文本输入或文件路径

动态工具

服务器会自动为每个可用的快捷指令生成工具,格式如下: - 工具名称:run_shortcut_[sanitized_shortcut_name] - 功能:运行特定的快捷指令 - 输入: - input(字符串,可选)- 传递给快捷指令的文本输入或文件路径

常见问题解答

  1. 该服务器支持哪些输入类型?
  2. 支持直接文本输入和基于文件的输入

  3. 如何处理快捷指令名称中的特殊字符?

  4. 服务器会对快捷指令名称进行清理以确保工具命名的兼容性

  5. 如何获取快捷指令的输出?

  6. 当快捷指令有输出时,服务器会返回输出结果

使用教程

使用依赖

需要安装以下依赖: 1. macOS系统 2. Node.js环境 3. macOS shortcuts CLI命令

安装教程

  1. 确保已安装Node.js
  2. 通过npm安装服务器: bash npm install -g mcp-server-siri-shortcuts

  3. 在Claude配置中添加: json { "mcpServers": { "siri-shortcuts": { "command": "npx", "args": ["mcp-server-siri-shortcuts"] } } }

调试方式

  1. 运行服务器: bash npx mcp-server-siri-shortcuts

  2. 检查快捷指令列表: bash shortcuts list

  3. 测试运行快捷指令: bash shortcuts run "My Shortcut"

许可证

None