3 v0.15.3 更新于 2026-11-07

simulator-use MCP Server

The iOS Simulator for coding agents: build Xcode projects, read the screen as text, tap by label.

适用客户端

本地客户端

Claude Desktop、Claude Code、Cursor、Cline 等支持本地 MCP 的客户端

本地运行(npm)

{
  "mcpServers": {
    "simulator-use": {
      "command": "npx",
      "args": [
        "-y",
        "simulator-use"
      ]
    }
  }
}

将上方 JSON 加入 MCP 客户端配置(如 Claude Desktop 的 claude_desktop_config.json 或项目的 .mcp.json)即可接入;远程接入按客户端要求填写 URL 与鉴权头。

app_run

构建 Xcode 项目并安装、启动应用,返回首屏内容,错误以 file:line 形式报告。

devices

列出本机可用的模拟器及其运行时、UDID、状态和 Xcode 版本。

device_use

选择并启动后续工具所使用的模拟器,可设置深色模式、干净状态栏等。

app_control

控制应用:安装、启动、终止、卸载、打开 URL、授权权限、推送、定位及外观、语言、时区等设置。

ui_look

读取当前屏幕内容,支持筛选匹配行、截图和保存完整无障碍树。

ui_act

按顺序执行点击、输入、滑动等 UI 操作步骤并返回变化结果。

app_logs

读取应用的打印输出和系统日志,支持 grep、等待关键字和查看崩溃记录。

tests_run

运行单元测试和 UI 测试,逐个用例返回结果、统计和失败位置。

screen_record

开始或停止屏幕录制,停止时返回 MP4 视频。

job_status

等待长时间构建任务完成,返回其结果或进度。

job_cancel

停止正在运行的作业。

cloud

启动、查看状态或停止云端 iPhone,使所有工具可在其上运行。