Apple Shortcuts

Apple Shortcuts MCP サーバー

macOS の shortcuts CLI を介して、Apple Shortcuts の機能を Rebel に公開する MCP サーバーです。

ワンクリックインストール

ボタンをクリックすると、ホストから APPLE_SHORTCUTS_TIMEOUT_MS の入力を求められます。

{
  "mcpServers": {
    "Apple Shortcuts": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-apple-shortcuts"
      ],
      "env": {
        "APPLE_SHORTCUTS_TIMEOUT_MS": "120000"
      }
    }
  }
}

ステータス

• バージョン： 0.2.1 · npm
• 認証： なし（server.json）
• ツール： 3（ショートカット）
• 実行環境： local-cli
• 機械可読： STATUS.json

前提条件

• Shortcuts アプリがインストールされた macOS
• Node.js 18+

セットアップ

cd ~/mcp-servers/apple-shortcuts
npm install
npm run build

認証情報や環境変数は必要ありません。

ツール

apple_shortcuts_list

利用可能なすべてのショートカットを一覧表示します。フォルダーで絞り込むこともできます。

apple_shortcuts_run

名前を指定してショートカットを実行します。テキスト入力は任意です。

apple_shortcuts_view

Mac の Shortcuts アプリのエディターで名前を指定したショートカットを開き、実行前にその動作を視覚的に確認できるようにします。定義は Shortcuts の GUI で開かれます。このツールは定義をテキストとして返しません。

設定

認証情報は必要ありません。実行時の動作を調整する任意の環境変数が 1 つあります。

出力の信頼モデル

ショートカット名（apple_shortcuts_list）とショートカットの標準出力（apple_shortcuts_run、apple_shortcuts_view）は、ローカルの shortcuts CLI から返されるユーザー作成のテキストです。コネクターは、このような出力をすべて <untrusted-content source="apple-shortcuts:..."> エンベロープで囲み、モデルが指示ではなくデータとして扱うようにします。apple_shortcuts_run／apple_shortcuts_view の確認、エラー、タイムアウトメッセージに含まれるショートカット名も、同じ方法でエンベロープに入れられます。名前は一覧出力に表示された時点で、攻撃者が制御できるテキストとなるためです。

Rebel に登録する

Settings → Connectors でコネクターを追加します。

• Command: node
• Args: ["<absolute path to>/mcp-servers/apple-shortcuts/dist/index.js"]（例：~/mcp-servers/apple-shortcuts/dist/index.js を絶対パスに展開）

注意事項

• macOS のみ — shortcuts CLI はほかのプラットフォームでは利用できません。
• GUI ダイアログを開いたり、確認を求めたりするショートカットは、コマンドラインから応答できません。永久にブロックされるのではなく、APPLE_SHORTCUTS_TIMEOUT_MS（デフォルトは 120s）の経過後に終了させられます。終了を確認できない場合（シグナルの送信に失敗した場合、または SIGKILL の後もプロセスが終了しない場合）、タイムアウトエラーでは停止したと断定せず、プロセスがまだ実行中の可能性があることを示します。
• 呼び出しごとに取得する標準出力／標準エラー出力には上限（各ストリーム 1,000,000 文字）があり、上限を超えた出力は破棄され、切り詰められたことを示す通知が付加されます。そのため、無制限の出力を生成するショートカットによってメモリが使い果たされることはありません。
• ショートカットの実行には、ログインユーザーと同じシステム権限が適用されます。ショートカットはメッセージの送信、ファイルの削除、購入、デバイスの制御、リモート API の呼び出しが可能です。apple_shortcuts_run には destructiveHint: true の注釈が付けられているため、ホストは実行前にユーザーの明示的な承認を求めます。