AI导哈

Mac指挥官MCP服务器

Mac Commander MCP Server是一个基于MCP（Model Context Protocol）协议的服务器，允许AI助手（如Claude Desktop、Claude Code和Cursor）与macOS应用程序进行视觉交互和控制。它提供了屏幕截图、鼠标控制、键盘输入、窗口管理、OCR文本识别等功能，适用于自动化测试、UI调试和错误检测等场景。

  • by ohqay
  • 更新于
在 GitHub 查看 ohqay/mac-commander

使用说明

产品定位

Mac Commander MCP Server是一个为AI助手提供macOS应用程序视觉交互和控制能力的服务器。

核心功能

  • 视觉AI：AI可以实际看到屏幕上的内容
  • 错误检测：自动发现错误对话框和消息
  • 全面控制：像人类一样点击、输入和导航
  • 应用测试：适用于测试移动应用、桌面软件或Web界面
  • 简单设置：5分钟内即可开始使用

适用场景

  • 自动化测试
  • UI调试
  • 错误检测
  • 应用测试
  • 自动化工作流程

工具列表

  • screenshot：捕获屏幕或特定区域的截图
  • click：在特定坐标点击
  • type_text：使用键盘输入文本
  • mouse_move：移动鼠标到特定坐标
  • key_press：按下键或组合键
  • check_for_errors：检查屏幕上的常见错误指示器
  • wait：等待指定时间
  • get_screen_info：获取屏幕尺寸信息
  • list_windows：列出所有打开的窗口
  • get_active_window：获取当前活动窗口的信息
  • find_window：通过标题查找窗口
  • focus_window：通过标题聚焦/激活窗口
  • get_window_info：获取特定窗口的详细信息
  • extract_text：使用OCR从屏幕提取文本
  • find_text：在屏幕上查找特定文本并获取其位置
  • drag_drop：从一个点拖动到另一个点
  • scroll：在任何方向滚动
  • hover：在特定位置悬停鼠标
  • click_hold：在特定坐标点击并按住鼠标按钮
  • relative_mouse_move：相对于当前位置移动鼠标
  • key_hold：按住键或组合键
  • type_with_delay：以类似人类的延迟输入文本

使用教程

使用依赖

  • macOS 13+ (Ventura或更高版本)
  • Node.js 18+ 和 npm
  • 支持MCP的AI客户端：

安装教程

自动安装（推荐）

# 克隆并运行安装程序
git clone https://github.com/ohqay/mac-commander.git
cd mac-commander
./install.sh

手动安装

# 克隆仓库
git clone https://github.com/your-username/mac-commander.git
cd mac-commander

# 安装依赖并构建
npm install
npm run build

# 测试是否工作
npm run inspector

调试方式

运行测试脚本以确保一切正常：

node test-server.js

配置

Claude Desktop设置

  1. 打开Claude Desktop并转到设置（齿轮图标）
  2. 点击开发者选项卡
  3. 点击编辑配置以打开配置文件
  4. 添加MCP服务器配置：
{
  "mcpServers": {
    "macos-simulator": {
      "command": "node",
      "args": ["/FULL/PATH/TO/mac-commander/build/index.js"]
    }
  }
}
  1. 保存文件并重启Claude Desktop
  2. 开始新的聊天 - 你应该看到一个🔨锤子图标，表示MCP已激活

验证是否工作

配置完成后：

  1. 重启你的AI客户端（Claude Desktop、Cursor等）
  2. 开始新的聊天/会话
  3. 寻找MCP指示器（Claude Desktop中的锤子图标）
  4. 尝试测试命令："Take a screenshot of my screen"

如果工作正常，你会看到AI成功截取屏幕截图！🎉

相关 MCP