macOS GUI Control MCP - Full Power Edition

macOS のマウス、キーボード、画面キャプチャをフル制御できる MCP サーバー。 削除系コマンドのみブロック、それ以外は全機能使用可能。

機能一覧

カテゴリ	機能	詳細
🖱️ マウス	`mouse_click`	指定座標をクリック
	`mouse_double_click`	ダブルクリック
	`mouse_right_click`	右クリック
	`mouse_move`	カーソル移動
	`mouse_drag`	ドラッグ操作
	`mouse_scroll`	スクロール (上下左右)
	`mouse_get_position`	現在のカーソル位置取得
⌨️ キーボード	`keyboard_type`	テキスト入力
	`keyboard_press`	キー押下 (修飾キー対応)
	`keyboard_shortcut`	共通ショートカット実行
📸 画面	`screen_capture`	スクリーンショット (全画面/領域)
	`screen_get_size`	画面サイズ取得
	`screen_get_color`	ピクセル色取得
🪟 ウィンドウ	`window_list`	開いているウィンドウ一覧
	`window_focus`	アプリをアクティブ化
	`window_move`	ウィンドウ移動
	`window_resize`	ウィンドウリサイズ
🚀 フルパワー	`run_applescript`	AppleScript 実行
	`run_shell`	シェルコマンド実行

前提条件

1. cliclick インストール (必須)

brew install cliclick

# 確認
cliclick -V

2. macOS 権限設定

システム設定 を開く
プライバシーとセキュリティ → アクセシビリティ
+ ボタンで Claude を追加
同様に 画面収録 にも Claude を追加

3. Node.js 18+

node --version  # v18.0.0 以上

ビルド

cd macOS-GUI-Control-MCP

# 依存関係インストール
npm install

# MCPB CLI インストール
npm install -g @anthropic-ai/mcpb

# パッケージ化
mcpb pack .
# → macos-control-1.0.0.mcpb が生成される

インストール方法

方法 A: Claude Desktop にインストール (推奨)

A-1. ダブルクリック (最も簡単)

macos-control-1.0.0.mcpb をダブルクリック
Claude Desktop が開いてインストールダイアログ表示
インストール をクリック

A-2. 設定画面から

Claude Desktop → 設定 → デスクトップアプリ → 拡張機能
展開済み拡張機能をインストール をクリック
.mcpb ファイルを選択

方法 B: Claude Code で直接使用

~/.claude.json に以下を追加:

{
  "mcpServers": {
    "macos-control": {
      "command": "node",
      "args": ["/path/to/macOS-GUI-Control-MCP/server/index.js"],
      "env": {
        "TIMEOUT": "30000",
        "LOG_OPERATIONS": "true"
      }
    }
  }
}

動作確認

新しいチャットで以下を試してみてください:

スクリーンショット撮って
マウスの現在位置教えて
Safari を開いて

使用例

マウス操作

「座標 500, 300 をクリックして」
「マウスを 100, 100 から 500, 500 にドラッグして」
「現在のカーソル位置を教えて」
「下に3回スクロールして」

キーボード操作

「Hello World とタイプして」
「Cmd+C を押して」
「コピーのショートカットを実行して」
「Enter キーを押して」

画面操作

「スクリーンショット撮って」
「画面サイズ教えて」
「座標 100, 100 のピクセル色を取得して」

ウィンドウ操作

「開いてるウィンドウ一覧見せて」
「Safari をアクティブにして」
「Terminal を座標 0, 0 に移動して」
「Finder のウィンドウを 800x600 にリサイズして」

フルパワー機能

「シェルで ls -la を実行して」
「AppleScript で Music アプリの現在の曲を取得して」
「シェルで pwd を実行して」

ブロックされるコマンド (削除のみ)

以下のパターンは安全のためブロックされます:

シェルコマンド

rm, rm -rf, rm -r
rmdir
unlink

AppleScript

delete file, delete folder, delete item
move ... to trash
empty trash

キーボードショートカット一覧

keyboard_shortcut で使用可能なショートカット:

ショートカット名	キー
`copy`	Cmd+C
`paste`	Cmd+V
`cut`	Cmd+X
`undo`	Cmd+Z
`redo`	Cmd+Shift+Z
`save`	Cmd+S
`select_all`	Cmd+A
`find`	Cmd+F
`new`	Cmd+N
`open`	Cmd+O
`close`	Cmd+W
`quit`	Cmd+Q
`tab`	Cmd+T
`refresh`	Cmd+R

環境変数

変数名	説明	デフォルト
`TIMEOUT`	コマンドタイムアウト (ms)	30000
`LOG_OPERATIONS`	操作ログ出力	true

トラブルシューティング

cliclick が見つからない

brew install cliclick

アクセシビリティ権限エラー

システム設定 → プライバシーとセキュリティ → アクセシビリティ
Claude (またはターミナル) を追加
アプリを再起動

画面収録権限エラー

システム設定 → プライバシーとセキュリティ → 画面収録
Claude (またはターミナル) を追加
アプリを再起動

AppleScript エラー

一部の AppleScript 操作には追加の権限が必要な場合があります。システム設定 → プライバシーとセキュリティ → オートメーションで許可を確認してください。

ライセンス

MIT

macOS GUI Control MCP