mcp-osascript

Claude で Mac を操作できます。 ウィンドウの移動、メニューのクリック、テキスト入力、クリップボードの読み取り、ブラウザータブの管理、スクリーンショットの撮影、ショートカットの実行などに対応しています。入力検証とセキュリティガードを備えた、型付きの 18 個のツールを利用できます。

公式 MCP レジストリに io.github.m0rvayne/mcp-osascript として登録されています。

クイックスタート

Claude Desktop — ワンクリックでインストール。 最新リリースから mcp-osascript-1.1.3.mcpb をダウンロードし、ダブルクリックしてください。Claude Desktop が拡張機能をインストールします。

または、設定ファイルに手動で追加します。

{
  "mcpServers": {
    "osascript": {
      "command": "npx",
      "args": ["-y", "mcp-osascript"]
    }
  }
}

これを Claude Desktop の設定（Settings → Developer → Edit Config）に追加し、Claude を再起動すれば準備完了です。

{
  "mcpServers": {
    "osascript": {
      "command": "npx",
      "args": ["-y", "mcp-osascript"]
    }
  }
}

claude mcp add osascript -- npx -y mcp-osascript

git clone https://github.com/m0rvayne/mcp-osascript.git
cd mcp-osascript && npm install
# then use: "command": "node", "args": ["/path/to/mcp-osascript/server/index.js"]

こんなプロンプトを試してみましょう

インストールしたら、Claude に次のように頼んでみてください。

ツール

入力検証、エラー分類、権限を考慮したエラーメッセージを備えた、型付きツールが18個あります。

自己修正するメニュー

Claudeが存在しないメニュー項目をクリックしようとすると、サーバーはその階層で利用可能な項目の一覧を自動的に返します。そのため、Claudeは正しい名前で再試行できます。この機能を備えたMCPサーバーはほかにありません。

User:   "Click File → Export as PDF in Preview"
Claude: calls app_menu click ["File", "Export as PDF"]
Server: "Menu item 'Export as PDF' not found in 'File'.
         Available: ['New from Clipboard', 'Open...', 'Close', 'Save',
         'Duplicate', 'Rename...', 'Export...', 'Export as PDF...']"
Claude: calls app_menu click ["File", "Export as PDF..."]
Server: "Clicked: File > Export as PDF..."

mcp-osascriptを選ぶ理由

スター数は人気の指標であり、品質の指標ではありません。どちらの代替プロジェクトも、このプロジェクトより数か月前から存在しています。上記の行は、実際の利用において異なる点を示しています。

セキュリティ監査

レッドチーム監査を4回実施しました（作者が依頼したもので、エージェントがソースコードを対象に攻撃的な検証を行います。第三者認証ではありません）。直近の監査では、v1.1.2を対象に3つのエージェントを並行して稼働させ、シェルの対象範囲、AppleScriptのエスケープ、情報漏えいを調査しました。その結果、ツールが別のツールのスキーム許可リストを密かに無効化する問題や、サーバーがデッドロックするまで同時実行スロットが解放されない可能性など、実際の欠陥が6件見つかりました。すべての問題を修正し、回帰テストを追加しています。escapeASは、13種類の文字列ブレイクアウト候補を実際のosascriptで検証し、いずれもすり抜けないことを確認しました。

権限

ツールは3つの階層で動作します。

• 権限不要 — クリップボード、通知、URL、アプリ、ファイル、ディスプレイ、ショートカット。すぐに利用できます。
• オートメーション — ブラウザーのタブ、最前面のアプリ。ブラウザーごとにmacOSの確認が一度表示されます。
• アクセシビリティ — キーボード、ウィンドウ、メニュー、非表示／再表示。システム設定 → プライバシーとセキュリティ → アクセシビリティで一度許可します。
• 画面収録 — スクリーンショットのみ。システム設定 → プライバシーとセキュリティ → 画面収録で許可します。

Claudeにcheck_permissionsを実行するよう依頼すると、すでに許可されている項目、それぞれの項目で利用可能になるツール、残りの設定を行うために開くべき設定パネルを正確に教えてくれます。確認処理は読み取り専用で、権限の確認ダイアログが表示されることはありません。

必要な権限がない場合、サーバーが具体的な手順を表示します。

"Accessibility permission required. Grant access to 'osascript'
in System Settings > Privacy & Security > Accessibility."

テスト

npm test

18種類すべてのツールを対象とする84件の統合テストがあります。入力検証、セキュリティ境界（URLスキームのブロック、プロトタイプ汚染、スクリプトサイズ制限）、タイムアウトの適用、権限エラーの処理、セキュリティ監査で見つかったすべての問題に対するリグレッションテストを網羅しています。

要件

• macOS 13以降（Ventura以降）
• Node.js 18以降

ライセンス

MIT