macOS Simulator MCP Server

产品定位

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客户端：

- Claude Desktop (推荐) - Claude Code - Cursor with MCP support - 任何其他MCP兼容的客户端

安装教程

自动安装（推荐）

# 克隆并运行安装程序
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成功截取屏幕截图！🎉