Siri Shortcuts MCP Server

Siri ショートカット MCP サーバー

この MCP サーバーは、Model Context Protocol（MCP）を通じて Siri ショートカット機能を利用できるようにします。macOS のショートカットアプリからショートカットを一覧表示、開く、実行できます。

機能

• すべての ショートカットを公開するため、LLM はショートカットアプリで利用可能なあらゆる機能を呼び出せます。
• 利用可能なすべてのショートカットを一覧表示
• ショートカットアプリでショートカットを開く
• オプションの入力パラメーターを指定してショートカットを実行
• 利用可能な各ショートカットのツールを動的に生成

ツール

基本ツール

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 に設定すると、LLM が利用可能なショートカットを把握できるように、利用可能なショートカットの一覧を 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 標準のエラー処理を実装しています