iOS 模拟器和真机 iPhone,用同一个 MCP。

StupidMirror 把已启动的 iOS 模拟器和你的 iPhone 列在一起,给 Claude Code、Codex 等 MCP 客户端提供同一套工具:读屏、点击、输入、安装构建、录屏、验证。它运行在你的 Mac 上,不需要模型 API Key。

StupidMirror 通过 USB 镜像 iPhone Air,控制已就绪,MCP 运行在 17373 端口

四步上手

需要 macOS 15 或更高版本。下载 StupidMirror 0.8.5 或更新版本,放入「应用程序」并打开。

启动模拟器

在 Xcode 里启动任意 iOS 模拟器,它运行期间会出现在 StupidMirror 中。屏幕组件只需为模拟器构建一次,无需签名,端口只在这台 Mac 上监听。

或者连接 iPhone

通过 USB 连接并信任这台 Mac,开启开发者模式,运行一次「设置这台 iPhone」。这一步也会打开 Wi-Fi 连接,之后不插线也能用。

接入 Agent

在「设置 → 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 模拟器设为合上、半开或展开。

只在这台 Mac 上运行

MCP Server 只监听 127.0.0.1,模拟器屏幕组件的端口也只在这台 Mac 上。采集、播放和 OCR 都在本机完成,StupidMirror 不会把屏幕上传给模型服务商。AI 客户端会收到它请求的截图和工具结果,按它自己的数据设置处理。

一台设备免费

不登录即可镜像并控制一台设备,模拟器和真机都一样。同时运行多台,比如模拟器加一台真机,需要 iTool 年度会员:支付宝 ¥99/年,或国际银行卡 US$26.49/年。年度会员包含 iTool 全部产品;月度会员不含 StupidMirror。

iTool 年度会员

购买前常见问题

支持 iOS 模拟器吗?

支持。已启动的 iOS 模拟器会自动出现在真机旁边。在你或 Agent 打开之前不会自动镜像,正在跑 UI 测试的模拟器不会被打扰。

需要 Xcode 吗?

模拟器需要,模拟器本身由 Xcode 提供。真机 iPhone 的设置会用这台 Mac 上的 Apple Development 身份签名屏幕组件,iOS 27 及以上的实时系统触控需要兼容的 Xcode。安卓不需要 Xcode。

同一个 Agent 能操作真机 iPhone 吗?

能,工具名完全一样。开启开发者模式后通过 USB 运行一次「设置这台 iPhone」,之后 USB 和 Wi-Fi 都能用。

也支持安卓吗?

支持。Android 11 及以上的手机和安卓模拟器通过 ADB 连接,使用同一套 MCP 工具。

免费吗?

不登录即可免费使用一台设备。同时使用多台需要 iTool 年度会员,¥99/年或 US$26.49/年。

Agent 怎么选择设备?

先调用 list_devices,再给每个工具传 device_id。模拟器和真机在同一个列表里。

屏幕内容会离开我的 Mac 吗?

StupidMirror 不会上传。Server 只监听 127.0.0.1。AI 客户端请求的截图会交给该客户端,按它的数据设置处理。

查看设备设置指南