启动模拟器
在 Xcode 里启动任意 iOS 模拟器,它运行期间会出现在 StupidMirror 中。屏幕组件只需为模拟器构建一次,无需签名,端口只在这台 Mac 上监听。
StupidMirror 把已启动的 iOS 模拟器和你的 iPhone 列在一起,给 Claude Code、Codex 等 MCP 客户端提供同一套工具:读屏、点击、输入、安装构建、录屏、验证。它运行在你的 Mac 上,不需要模型 API Key。

需要 macOS 15 或更高版本。下载 StupidMirror 0.8.5 或更新版本,放入「应用程序」并打开。
在 Xcode 里启动任意 iOS 模拟器,它运行期间会出现在 StupidMirror 中。屏幕组件只需为模拟器构建一次,无需签名,端口只在这台 Mac 上监听。
通过 USB 连接并信任这台 Mac,开启开发者模式,运行一次「设置这台 iPhone」。这一步也会打开 Wi-Fi 连接,之后不插线也能用。
在「设置 → MCP 自动化」里点击「接入 Claude Code」或「接入 Codex」,已装好的部分会跳过。
新开会话,试试:「列出我的设备,打开正在运行的模拟器,读取当前屏幕,先不要点击。」
「接入 Claude Code」注册的就是这条命令:走 stdio 桥接,Claude Code 的配置里不会写入令牌。
claude mcp add --scope user stupidmirror -- /Applications/StupidMirror.app/Contents/Helpers/StupidMirrorMCPBridge --app /Applications/StupidMirror.app
其他 MCP 客户端:本机 Streamable HTTP(默认端口),Bearer 令牌在生成的配置里。
http://127.0.0.1:17373/mcp
Authorization: Bearer <token>
observe_screen 返回实时画面和本地 Apple Vision OCR 结果;find_any_element 用多个候选文字找到控件。
tap_text、tap_element、swipe、long_press。模拟器走模拟器系统 HID;iOS 27 及以上的 iPhone 走实时系统 HID,其他版本走 WebDriverAgent。replace_text 修改输入框并校验结果。
install_app 给模拟器装模拟器构建的 .app,给 iPhone 装签名的 .app 或 .ipa。open_url 打开深链;activate_app、terminate_app 启动和结束应用。
wait_for、assert_screen 确认文字出现或消失后,Agent 再继续下一步。
start_recording 把实时镜像录成最长 10 分钟的 .mp4,保存在 ~/Movies/StupidMirror。
有兼容的 Xcode 运行时时,set_device_posture 可把 iPhone Duo 模拟器设为合上、半开或展开。
MCP Server 只监听 127.0.0.1,模拟器屏幕组件的端口也只在这台 Mac 上。采集、播放和 OCR 都在本机完成,StupidMirror 不会把屏幕上传给模型服务商。AI 客户端会收到它请求的截图和工具结果,按它自己的数据设置处理。
不登录即可镜像并控制一台设备,模拟器和真机都一样。同时运行多台,比如模拟器加一台真机,需要 iTool 年度会员:支付宝 ¥99/年,或国际银行卡 US$26.49/年。年度会员包含 iTool 全部产品;月度会员不含 StupidMirror。
iTool 年度会员支持。已启动的 iOS 模拟器会自动出现在真机旁边。在你或 Agent 打开之前不会自动镜像,正在跑 UI 测试的模拟器不会被打扰。
模拟器需要,模拟器本身由 Xcode 提供。真机 iPhone 的设置会用这台 Mac 上的 Apple Development 身份签名屏幕组件,iOS 27 及以上的实时系统触控需要兼容的 Xcode。安卓不需要 Xcode。
能,工具名完全一样。开启开发者模式后通过 USB 运行一次「设置这台 iPhone」,之后 USB 和 Wi-Fi 都能用。
支持。Android 11 及以上的手机和安卓模拟器通过 ADB 连接,使用同一套 MCP 工具。
不登录即可免费使用一台设备。同时使用多台需要 iTool 年度会员,¥99/年或 US$26.49/年。
先调用 list_devices,再给每个工具传 device_id。模拟器和真机在同一个列表里。
StupidMirror 不会上传。Server 只监听 127.0.0.1。AI 客户端请求的截图会交给该客户端,按它的数据设置处理。