이 MCP 서버는 모델 컨텍스트 프로토콜(MCP)을 통해 시리 바로가기 기능에 접근할 수 있게 합니다. macOS 바로가기 앱에서 바로가기를 나열, 열기, 실행할 수 있게 해줍니다.

특징

• _모든 _ 단축키를 노출하여 LLM이 단축키 앱에서 제공하는 모든 것을 호출할 수 있습니다.
• 모든 사용 가능한 단축키 목록
• 바로가기 앱에서 바로가기 열기
• 선택적 입력 매개변수를 가진 단축키 실행
• 각 사용 가능한 단축키마다 동적으로 생성되는 도구

도구

기본 도구

1. list_shortcuts

• 시스템에서 사용 가능한 모든 Siri 단축어 목록
• 입력 필요 없음
• 반환: 단축키 이름 배열

2. open_shortcut

• 바로가기 앱에서 바로가기 열기
• 입력:
• name (문자열): 열기 위한 지름길 이름

3. run_shortcut

• 선택적 입력으로 단축키를 실행하는 것
• 입력:
• name (문자열): 실행할 바로가기의 이름 또는 식별자(UUID)
• input (문자열, 선택): 단축키로 전달할 텍스트 입력 또는 파일 경로

다이내믹 툴즈

서버는 다음과 같은 형식의 각 사용 가능한 단축키에 대해 자동으로 추가 도구를 생성합니다:

• 공구명: run_shortcut_[sanitized_shortcut_name]
• 설명: 특정 단축키를 실행합니다
• 입력:

Siri Shortcuts MCP Server

This MCP server provides access to Siri shortcuts functionality via the Model Context Protocol (MCP). It allows listing, opening, and running shortcuts from the macOS Shortcuts app.

Features

• Exposes all shortcuts, meaning the LLM can call anything that is available in the Shortcuts app.
• List all available shortcuts
• Open shortcuts in the Shortcuts app
• Run shortcuts with optional input parameters
• Dynamically generated tools for each available shortcut

Tools

Base Tools

1. list_shortcuts

   • Lists all available Siri shortcuts on the system
   • No input required
   • Returns: Array of shortcut names

   {
     "shortcuts": [{ "name": "My Shortcut 1" }, { "name": "My Shortcut 2" }]
   }
   

2. open_shortcut

   • Opens a shortcut in the Shortcuts app
   • Input:
     • name (string): Name of the shortcut to open

3. run_shortcut

   • Runs a shortcut with optional input
   • Input:
     • name (string): Name or identifier (UUID) of the shortcut to run
     • input (string, optional): Text input or filepath to pass to the shortcut

Dynamic Tools

The server automatically generates additional tools for each available shortcut in the format:

• Tool name: run_shortcut_[sanitized_shortcut_name]
• Description: Runs the specific shortcut
• Input:
  • input (string, optional): Text input or filepath to pass to the shortcut

Configuration

The server supports the following environment variables:

• GENERATE_SHORTCUT_TOOLS (default: true): When set to false, disables the generation of dynamic shortcut tools. Only the base tools (list_shortcuts, open_shortcut, run_shortcut) will be available.
• INJECT_SHORTCUT_LIST (default: false): When set to true, injects the list of available shortcuts into the run_shortcut tool description to help the LLM understand which shortcuts are available.

Usage with Claude

Add to your Claude configuration:

{
  "mcpServers": {
    "siri-shortcuts": {
      "command": "npx",
      "args": ["mcp-server-siri-shortcuts"],
      "env": {
        "GENERATE_SHORTCUT_TOOLS": "true",
        "INJECT_SHORTCUT_LIST": "false"
      }
    }
  }
}

Implementation Details

• Uses the macOS shortcuts CLI command under the hood
• Sanitizes shortcut names for tool naming compatibility
• Supports both direct text input and file-based input
• Returns shortcut output when available
• Implements standard MCP error handling