你的 AI 代理在真实的模拟器上
测试移动应用
新屏幕是代理写的,可它从没见过这个屏幕运行起来的样子。有了 AgentsRoom,代理会在你的电脑上启动 iOS 模拟器或 Android 模拟器,安装构建,在屏幕上逐一轻触检查,并在说完成之前把截图发给你。
AgentsRoom-Device MCP 服务器为 Claude Code、Codex、Cursor 和其他代理 CLI 提供一套设备工具:启动设备,安装 .app 或 .apk,打开应用,打开深层链接或 Expo dev client URL,轻触、滑动、输入,按主屏幕或返回键,读取屏幕,截图,读取日志。你可以在 AgentsRoom 里实时观看设备,随时接管操控。
代理
设备工具
- device_boot
- device_install_app
- device_tap
- device_screenshot
编程代理几分钟就能写出一个 React Native 屏幕、一个 SwiftUI 视图或一个 Kotlin Activity。但检查它能不能用,仍然是你的事:构建、打开模拟器、沿着流程点一遍、发现按钮被键盘挡住了,再把截图贴回对话里。
对于 Web 应用,代理早就能在浏览器里测试自己的工作。移动应用在你每天使用的工具里却没有对应的东西:iOS 模拟器 MCP 或 Android 模拟器 MCP 得自己去找、去安装,再为每个 CLI 逐个配置。
AgentsRoom 补上了这一块。你授予“设备访问”的代理,无论用哪个 CLI,都能拿到设备工具。它操控的是你电脑上已有的模拟器,它做的每一步你都能实时看到。
代理能在设备上做什么
你手动检查一个移动端屏幕的那些步骤,由写这个屏幕的代理自己完成。
启动、安装、打开
代理列出你电脑上的模拟器,启动其中一台并等待它就绪,安装模拟器用的 .app 或 .apk,然后按 bundle ID 或包名打开应用。
深层链接与 Expo
它可以打开深层链接或 Expo dev client URL。在 Android 上,它能转发 Metro 需要的端口,让模拟器连上你电脑上运行的打包服务。
轻触、滑动、输入
它读取屏幕上的元素,按引用或坐标轻触,滑动,输入文字,按主屏幕、返回、Enter 或音量键。每个会改变屏幕的操作之后,都会返回一张截图。
在 AgentsRoom 里实时看屏幕
“测试 > 设备”实时显示设备画面,最高每秒 30 帧。这里可以搜索所有模拟器,有启动和停止、主屏幕、返回按钮,还有一个复制截图的按钮。
轻触一下就能接管
在实时屏幕上轻触、拖动或输入,操控权就到了你手上:代理会等待,并有横幅提示。点“交还操控”把设备还给代理;2 分钟内没有任何操作,也会自动交还。
默认关闭,按代理逐个开启
只有拥有“设备访问”的代理才能拿到这些工具,而且每次操作都会重新检查权限。同一台设备同一时间只由一个代理操控。最近操作会列出来,但从不记录输入的文字。
工作原理
你只需勾选一次,检查交给代理。
- 1
给代理开启“设备访问”
编辑代理,打开“能力”部分,勾选“设备访问(iOS 模拟器、Android 模拟器)”。你也可以把它设为新代理的默认值:在“设置”中对所有项目生效,或在某个项目的设置中只对该项目生效。
- 2
请它在设备上检查
让代理为模拟器构建应用(Expo 项目用 npx expo run:ios 或 npx expo run:android),并检查某个屏幕。它会调用 device_list,没有设备在运行时就启动一台,然后安装构建并打开应用。
- 3
它把屏幕走一遍
代理像测试人员一样读取屏幕、轻触、输入、滑动。遇到失败,它会读取应用日志,修改代码再试一次,然后把结果截图发给你。
- 4
观看,或者接管
在右侧面板打开“测试 > 设备”,可以实时看到设备画面,以及是哪个代理在操控。轻触屏幕即可接管,用完后点“交还操控”。
你的电脑需要什么
iOS:一台装有 Xcode 的 Mac(只装 Command Line Tools 不够),以及至少一个 iOS 模拟器运行时。启动设备、安装、链接、截图和日志在任何 Mac 上都能用。触控屏幕、输入和实时画面需要 Apple Silicon Mac 和 serve-sim。serve-sim 是一个开源工具,用 npm install -g serve-sim 安装一次即可。
Android:Android Studio 中的 Android SDK,装好 Android Emulator 软件包,并在 Device Manager 中至少创建一台虚拟设备。macOS、Windows 和 Linux 都支持。Windows 需要硬件虚拟化(Windows Hypervisor Platform),Linux 需要能访问 /dev/kvm。
缺少什么时,AgentsRoom 会在“设备”标签页和代理自己的回答里告诉你该装什么、怎么装。不会在你不知情的情况下下载任何东西。
限制
- 仅支持模拟器:不支持实体 iPhone 和 Android 手机,也不支持 watchOS、tvOS 和 visionOS。
- iOS 模拟器只存在于 Mac 上。在 Windows 和 Linux 上,代理操控的是 Android 模拟器。
- 在 Xcode 27 下,模拟器窗口必须保持可见,并且 AgentsRoom 需要“辅助功能”权限才能触控屏幕。
- 在 Android 模拟器上,代理只能输入纯 ASCII 文本。在 iOS 模拟器上,任何字符和任何键盘布局都可以。
- Android 实时屏幕适用于从 AgentsRoom 启动的模拟器。从 Android Studio 启动的模拟器仍然接受代理的所有操作,但在你从“测试 > 设备”启动它之前,不会显示实时屏幕。
- 一个代理同时最多拥有两台由 AgentsRoom 启动的设备,因为每个模拟器会占用 2 到 4 GB 内存。代理不能关闭设备。AgentsRoom 启动的设备会在你退出应用时停止;你自己启动的设备从不受影响。
- 关闭“设备访问”会在代理的下一次操作时生效。为已在运行的代理开启时,要在该代理重启后才生效。
常见问题
问我们其他问题Claude Code 能自己在模拟器上测试我的 iOS 应用吗?
Codex 和 Cursor 也有 iOS 模拟器 MCP 或 Android 模拟器 MCP 吗?
支持 Expo 和 React Native 吗?
我能看到代理在模拟器上做了什么吗?
在 Windows 或 Linux 上能用吗?
代理能使用我的实体 iPhone 或 Android 手机吗?
如果两个代理想用同一个模拟器会怎样?
让代理操控设备安全吗?
QA 代理能替我的开发代理测试移动应用吗?
我能在手机上看到代理的截图吗?
延伸阅读
您可能还喜欢
Browser MCP • Embedded Chromium • Agent-driven QA
您的 QA 代理在 localhost 上打开一个真实的 Chromium,点击、输入、截图、读取 console,确认功能确实可用,无需编写 Playwright 配置。
代理委派:开发到 QA : 测试用更便宜的模型
你的开发代理通过 MCP 把测试执行交给更便宜的 QA 代理。贵的模型专注在代码上,token 账单和上下文都保持精简。
实时预览
AgentsRoom的localhost隧道可以将任何本地开发服务器暴露为带有自定义子域名的公共HTTPS URL。ADE内置的免费ngrok替代方案。通过WebSocket直通即时分享localhost,支持Vite HMR、Next.js热重载和Expo Metro打包器。
让代理自己检查自己的屏幕。
由代理操控的模拟器已包含在 macOS、Windows 和 Linux 版 AgentsRoom 中。iOS 模拟器需要 Mac。
配套应用:随时随地监控你的 Agent
使用 Claude、Codex、Antigravity CLI 或其他 AI 提供商。
把 Bug 和需求直接发送到您的公开待办清单。