mac-use-mcp

mac-use-mcp

警告

このツールは、マウス、キーボード、画面を完全に制御できます。 プライバシーを保護し、エージェントによる誤ったデータ損失を防ぐため、サンドボックス環境で使用してください。このツールを通じて実行された操作については、お客様が責任を負います。

MCP 経由で macOS デスクトップを自動化する、ネイティブ依存関係ゼロのツールです。

AI エージェントに macOS 上での目と手を与え、アプリケーションのクリック、入力、スクリーンショットの撮影、調査ができます。

ユースケース

• 自動 UI テスト — ボタンをクリックし、get_ui_elements で要素の状態を確認し、screenshot で画面の内容を検証します
• デスクトップワークフローの自動化 — open_application でアプリを起動し、type_text でフォームに入力し、click_menu でメニューを操作します
• スクリーンショットによる監視 — screenshot で画面領域を定期的にキャプチャし、視覚的な差分検出やアラートに使用します
• アクセシビリティの調査 — get_ui_elements で UI 要素ツリーを照会し、QA やコンプライアンスの確認に役立てます
• AI エージェントによるコンピューター操作 — screenshot、click、type_text などを使って、LLM に macOS 上での目と手を与えます

mac-use-mcp を選ぶ理由

• すぐに使えます — npx mac-use-mcp を実行し、macOS の権限を 2 つ許可するだけです。node-gyp、Xcode ツール、ビルド手順は必要ありません。
• 1 つのサーバーに 18 個のツール — スクリーンショット、クリック、キー入力、ウィンドウ管理、アクセシビリティの調査、クリップボードに対応します。
• Intel と Apple Silicon の macOS 13 以降に対応 — ネイティブアドオンがなく、アーキテクチャに関する問題もありません。

インストール

要件： macOS 13 以降、Node.js 22 以降。サーバーは stdio トランスポートで通信します。

このパッケージは macOS でのみ動作します。他のオペレーティングシステムではインストールを拒否します。

ビルド手順も、ネイティブ依存関係もありません。実行するだけです。

npx mac-use-mcp

初回実行時、npx はパッケージをインストールするか確認します。確認を省略するには、npx -y mac-use-mcp を使用してください。

ヒント

モデルの選択は重要です。 デスクトップの自動化では、トークン使用量が積み重なるスクリーンショットと操作のループが発生します。推論能力、優れた視覚認識、信頼性の高いツール呼び出しを備えた高速なモデルをおすすめします。

モデル	プロバイダー
Gemini 3 Flash	Google
Claude Sonnet 4.6	Anthropic
GPT-5 mini	OpenAI
MiniMax-M2.5	MiniMax
Kimi K2.5	Moonshot AI
Qwen3.5	Alibaba
GLM-4.7	Zhipu AI

権限の設定

mac-use-mcp を使用するには、macOS の権限が 2 つ必要です。一度許可すれば、準備完了です。

アクセシビリティ

マウスとキーボードの制御に必要です。

1. システム設定 > プライバシーとセキュリティ > アクセシビリティを開きます
2. + ボタンをクリックします
3. MCP クライアントアプリケーション（Claude Desktop、使用するターミナルエミュレーターなど）を追加します
4. トグルが有効になっていることを確認します

画面収録

スクリーンショットの撮影に必要です。

1. システム設定 > プライバシーとセキュリティ > 画面収録を開きます
2. + ボタンをクリックします
3. MCP クライアントアプリケーションを追加します
4. トグルが有効になっていることを確認します
5. 再起動を求められた場合は、アプリケーションを再起動します

権限の確認

両方の権限を許可し、MCP クライアントを設定した後（次のセクションを参照）、check_permissions ツールを使用して、すべて正常に動作していることを確認します。

> check_permissions
✓ Accessibility: granted
✓ Screen Recording: granted

MCP クライアントの設定

claude mcp add mac-use-mcp -- npx mac-use-mcp

{
  "mcpServers": {
    "mac-use-mcp": {
      "command": "npx",
      "args": ["mac-use-mcp"]
    }
  }
}

[mcp_servers.mac-use]
command = "npx"
args = ["-y", "mac-use-mcp"]

codex mcp add mac-use -- npx -y mac-use-mcp

{
  "mcpServers": {
    "mac-use-mcp": {
      "command": "npx",
      "args": ["mac-use-mcp"]
    }
  }
}

{
  "mcpServers": {
    "mac-use-mcp": {
      "command": "npx",
      "args": ["mac-use-mcp"]
    }
  }
}

{
  "servers": {
    "mac-use-mcp": {
      "command": "npx",
      "args": ["mac-use-mcp"]
    }
  }
}

{
  "mcpServers": {
    "mac-use-mcp": {
      "command": "npx",
      "args": ["mac-use-mcp"]
    }
  }
}

{
  "mcpServers": {
    "mac-use-mcp": {
      "command": "npx",
      "args": ["mac-use-mcp"]
    }
  }
}

{
  "mcpServers": {
    "mac-use-mcp": {
      "command": "npx",
      "args": ["mac-use-mcp"]
    }
  }
}

{
  "mcpServers": {
    "mac-use-mcp": {
      "command": "npx",
      "args": ["mac-use-mcp"]
    }
  }
}

ツール

この Node.js MCP サーバーは、MCP 互換クライアントでマウス、キーボード、画面を操作するための 18 個のツールを提供します。

画面

入力

ウィンドウとアプリ

アプリ名はあいまい検索に対応しており、"chrome" は "Google Chrome" に、"code" は "Code" に解決されます。

アクセシビリティ

クリップボード

ユーティリティ

例

mac-use-mcp ツールを使用する一般的なワークフローパターン：

特定のウィンドウのスクリーンショットを撮る

1. focus_window({ app: "Safari" })
2. screenshot({ mode: "window", window_title: "Safari" })

ダイアログのボタンをクリックする

1. get_ui_elements({ app: "Finder", role: "AXButton" })
   → finds "OK" button at position (500, 300)
2. click({ x: 500, y: 300 })

メニュー操作を自動化する

1. open_application({ name: "TextEdit" })
2. click_menu({ app: "TextEdit", path: "Format > Make Plain Text" })

アプリ間でテキストをコピーする

1. focus_window({ app: "Safari" })
2. press_key({ key: "cmd+a" })       # select all
3. press_key({ key: "cmd+c" })       # copy
4. focus_window({ app: "Notes" })
5. press_key({ key: "cmd+v" })       # paste

動作の仕組み

• Swift binary がマウス入力（CGEvent）、画面キャプチャ（CGWindowListCreateImage）、ウィンドウの列挙（CGWindowListCopyWindowInfo）、UI 要素のクエリ（Accessibility API）を処理します
• AppleScript がキーボード入力（System Events key code）、ウィンドウのフォーカス、メニューのクリックを処理します
• Node.js MCP server が stdio 経由ですべてを統括し、MCP ツール呼び出しをシステム操作に変換します
• ネイティブの Node.js アドオンはありません — Swift バイナリは事前にコンパイルされ、npm パッケージに同梱されています
• シリアル実行キュー がシステム操作間の競合状態を防ぎます

既知の制限事項

• Sequoia での画面収録の確認プロンプト：macOS 15 では、画面収録へのアクセスを再確認するよう毎月システムプロンプトが表示されます。これは OS レベルの動作であり、抑止できません。
• セキュア入力フィールド：パスワードフィールドなどのセキュアなテキスト入力では、合成キーボードイベントがブロックされます。これは macOS のセキュリティ機能です。
• macOS 26 以降でのキーボード入力：CGEvent によるキーボードイベントの合成は、通知なくブロックされます。回避策として AppleScript（System Events key code）でキーボード入力を行いますが、一部の例外的なケースでは動作が異なる場合があります。
• システムダイアログ：FileVault のロック解除やログインウィンドウなど、一部のシステムレベルのダイアログは、macOS のセキュリティ制限によりプログラムから操作できません。
• ヘッドレス環境／CI：グラフィカルセッションが必要です。標準の GitHub Actions ランナーなど、ヘッドレスの macOS 環境には対応していません。

トラブルシューティング

関連プロジェクト

• Playwright MCP — アクセシビリティツリーを使ったブラウザー自動化です。Web のみを対象とするタスクで mac-use-mcp を補完します。
• Peekaboo — ScreenCaptureKit を使った macOS の画面自動化です。macOS 15 以降と Swift のビルドが必要です。
• awesome-mcp-servers — エコシステム全体から厳選した MCP サーバーのリストです。

コントリビューション

開発環境のセットアップとガイドラインについては、CONTRIBUTING.md を参照してください。

変更履歴

セキュリティ

脆弱性を報告するには、SECURITY.md を参照してください。

サポート

• バグを見つけましたか？ Issue を作成
• 機能のアイデアがありますか？ Issue を作成
• このプロジェクトを気に入りましたか？ Star を付けてください。他の人が mac-use-mcp を見つけやすくなります。

ライセンス

MIT © 2026 antbotlab

macOS は Apple Inc. の商標であり、米国およびその他の国や地域で登録されています。