产品定位
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设置
- 打开Claude Desktop并转到设置（齿轮图标）
- 点击开发者选项卡
- 点击编辑配置以打开配置文件
- 添加MCP服务器配置：
{
"mcpServers": {
"macos-simulator": {
"command": "node",
"args": ["/FULL/PATH/TO/mac-commander/build/index.js"]
}
}
}- 保存文件并重启Claude Desktop
- 开始新的聊天 - 你应该看到一个🔨锤子图标，表示MCP已激活
验证是否工作
配置完成后：
- 重启你的AI客户端（Claude Desktop、Cursor等）
- 开始新的聊天/会话
- 寻找MCP指示器（Claude Desktop中的锤子图标）
- 尝试测试命令："Take a screenshot of my screen"
如果工作正常，你会看到AI成功截取屏幕截图！🎉