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 権限設定

1. システム設定 を開く
2. プライバシーとセキュリティ → アクセシビリティ
3. + ボタンで Claude を追加
4. 同様に 画面収録 にも 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. ダブルクリック (最も簡単)

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

A-2. 設定画面から

1. Claude Desktop → 設定 → デスクトップアプリ → 拡張機能
2. 展開済み拡張機能をインストール をクリック
3. .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

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

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

画面収録権限エラー

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

AppleScript エラー

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

ライセンス

MIT