启动模拟器
启动一个 Android 虚拟设备(AVD),运行期间它会以 AVD 名称出现在 StupidMirror 中。
StupidMirror 自动发现正在运行的安卓模拟器和已授权的 ADB 设备,用内置的 scrcpy server 镜像和控制,并通过 adb 读取无障碍树。Claude Code、Codex 等 MCP 客户端用的工具和操作 iPhone 时完全一样。

需要 macOS 15 或更高版本,并在 Mac 上安装 Android SDK Platform-Tools(adb)。缺少 adb 时应用会提醒;scrcpy server 已内置。
启动一个 Android 虚拟设备(AVD),运行期间它会以 AVD 名称出现在 StupidMirror 中。
Android 11 及以上:开启 USB 调试,连接手机并授权这台 Mac。
在「设置 → 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 返回 scrcpy 实时画面和本地 OCR 结果;需要时 get_ui_tree 通过 adb 读取 uiautomator 层级。
tap_text、tap_element、swipe、long_press、type_text、replace_text 通过 scrcpy 控制通道执行;中文等文字通过粘贴输入,之后会恢复你原来的剪贴板。
back 按安卓返回键,press_button 发送主屏幕或音量键,app_switcher 打开最近任务。
install_app 安装 .apk,重装时保留应用数据;activate_app、terminate_app 按包名启动和结束应用。
wait_for、assert_screen 确认文字出现或消失后,Agent 再继续下一步。
start_recording 把实时镜像录成最长 10 分钟的 .mp4,保存在 ~/Movies/StupidMirror。
MCP Server 只监听 127.0.0.1,设备控制通过这台 Mac 上的 adb 完成。采集、播放和 OCR 都在本机完成,StupidMirror 不会把屏幕上传给模型服务商。AI 客户端会收到它请求的截图和工具结果,按它自己的数据设置处理。
不登录即可镜像并控制一台设备,模拟器和真机都一样。同时运行多台,比如模拟器加一台真机,需要 iTool 年度会员:支付宝 ¥99/年,或国际银行卡 US$26.49/年。年度会员包含 iTool 全部产品;月度会员不含 StupidMirror。
iTool 年度会员在这台 Mac 上运行的安卓模拟器。它们像手机一样通过 ADB 连接,按 AVD 名称列出。在你或 Agent 打开之前不会自动镜像。
需要的是 Android SDK Platform-Tools 里的 adb;Android Studio 只用来创建和运行模拟器。镜像和控制所用的 scrcpy server 已随应用提供,不会在设备上安装任何东西。
Android 11 及以上,真机和模拟器都一样。
能。通过 USB 或 Wi-Fi 连接的真机 iPhone 和已启动的 iOS 模拟器使用同样的工具名。
不登录即可免费使用一台设备。同时使用多台需要 iTool 年度会员,¥99/年或 US$26.49/年。
可以,需要 iTool 年度会员。先调用 list_devices,再用 device_id 指定每台设备。
StupidMirror 不会上传。Server 只监听 127.0.0.1。AI 客户端请求的截图会交给该客户端,按它的数据设置处理。