# 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 インストール (必須)
```bash
brew install cliclick
# 確認
cliclick -V
```
### 2. macOS 権限設定
1. **システム設定** を開く
2. **プライバシーとセキュリティ** → **アクセシビリティ**
3. **+** ボタンで **Claude** を追加
4. 同様に **画面収録** にも **Claude** を追加
### 3. Node.js 18+
```bash
node --version # v18.0.0 以上
```
## ビルド
```bash
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` に以下を追加:
```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 が見つからない
```bash
brew install cliclick
```
### アクセシビリティ権限エラー
1. システム設定 → プライバシーとセキュリティ → アクセシビリティ
2. Claude (またはターミナル) を追加
3. アプリを再起動
### 画面収録権限エラー
1. システム設定 → プライバシーとセキュリティ → 画面収録
2. Claude (またはターミナル) を追加
3. アプリを再起動
### AppleScript エラー
一部の AppleScript 操作には追加の権限が必要な場合があります。
システム設定 → プライバシーとセキュリティ → オートメーション で許可を確認してください。
## ライセンス
MIT
