AI导哈

macOS GUI 控制服务器

一个用于控制 macOS 鼠标、键盘、屏幕截图和窗口操作的服务器，支持 AppleScript 和 shell 命令执行。

  • by Akira-Papa
  • JavaScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 Akira-Papa/macOS-GUI-Control-MCP

使用说明

macOS GUI控制MCP-全功能版

可全面控制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. + 按钮 克劳德 添加
  4. 同样地 画面收録 也 克劳德 添加

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. 克劳德桌面版→ 设定 → 桌面应用程序 → 扩张机能
  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 操作日志输出

故障排除

找不到cliclick

brew install cliclick

辅助功能权限错误

  1. 系统设置-隐私和安全-辅助功能
  2. 添加Claude（或终端）
  3. 重新启动应用程序

画面收录权限错误

  1. 系统设置→隐私和安全→画面收录
  2. 添加Claude（或终端）
  3. 重新启动应用程序

AppleScript错误

某些应用程序脚本操作可能需要附加权限。 请通过系统设置→隐私和安全→自动化确认许可。

许可证

麻省理工学院

相关 MCP