源码系统概览
文章正文
Agent Device 是一套开源的移动应用自动化验证工具源码，面向 AI 编码代理，提供命令行工具、MCP 服务和 Node.js 接口三种接入方式，支持全平台移动设备的自动化测试和管理。
源码简介
项目由 Callstack 团队开发，基于 TypeScript 和 React Native 构建，支持 iOS、Android、HarmonyOS、电视、网页、macOS、Linux 全平台。包含 iOS 运行器、Android 快照助手、Maestro 兼容引擎三大核心组件。使用 pnpm 管理二十多个工作空间包。命令行工具一条命令启动验证，MCP 服务让 AI 代理直接调用设备操作，无需编写额外桥接代码。项目采用 MIT 协议开源，社区活跃，欢迎贡献 star 和 fork。最后更新 2026 年，更新日志见 GitHub 发布页面。当前版本号 v1.0.0。
适用场景
适用于 AI 编码代理自动验证移动应用、持续集成流水线集成移动端测试、React Native 应用自动化回归测试等场景，可提升移动开发团队的测试效率。
技术栈与运行环境
主要使用 TypeScript 开发，包含两千七百多个 TypeScript 文件。前端框架使用 React Native 和 Expo。原生桥接使用 Swift 和 Kotlin。MCP 服务协议支持，iOS 测试使用 XCUITest 框架。
功能亮点
- CLI 命令行工具，一条命令启动移动应用验证
- MCP server 集成，AI 代理直接调用设备操作
- 支持 iOS/Android/HarmonyOS/TV/Web 多平台
- 内置 Maestro 兼容引擎，复用现有测试用例
- Typed Node.js API，可编程集成到任何 JS/TS 项目
技术架构与部署指南
安装与部署提示
首先克隆仓库到本地，使用 pnpm 安装依赖，然后 pnpm build 构建项目。命令行工具可用 npm 全局安装。最后更新 2026 年，更新日志见 GitHub 发布页面。当前版本号 v1.0.0。
截图与演示说明
封面图展示 Agent Device 项目横幅，包含项目名称和移动设备图标阵列。横幅展示了该工具支持的多平台，包括 iOS、Android、HarmonyOS、电视和网页端，以及 AI 代理通过 MCP 协议控制移动设备的流程示意图。横幅右侧展示代理开发闭环流程，人类分配任务，代理编写和审查代码，设备验证移动应用，代码合并后发现问题再修复。截图来自 GitHub README 横幅图片，直观呈现了移动应用自动化验证工具的全流程和核心组件布局。
常见问题
问：agent-device 是什么？
agent-device 是面向 AI 编码代理的移动应用自动化验证工具，支持 CLI/MCP server/Node.js API 三种接入方式。
问：agent-device 和 Appium 有什么区别？
agent-device 原生集成 MCP 协议，AI 代理可直接调用；Appium 需额外封装。agent-device 还内置 Maestro 兼容引擎。
问：agent-device 怎么安装？
npm install -g agent-device 全局安装 CLI，或 pnpm install 本地开发。需要 Node.js 18+。
问：agent-device 免费吗？
采用 MIT 开源协议，完全免费使用，包括商业用途。
问：支持哪些平台？
支持 iOS/Android/HarmonyOS/TV/Web/macOS/Linux 全平台移动应用验证。
安全风险提示
未发现高风险函数。跨域资源共享配置由 MCP 服务控制，需限制来源域名。Docker 容器部署时注意设备模拟器端口暴露问题，建议使用内网部署。iOS 测试需要苹果开发者账号和有效证书。
下载说明
已打包为 zip 压缩包，包含三千三百多个文件。下载后解压即可使用，包含完整的 TypeScript 源码和原生桥接代码。提取码为 8888。
对比，区别 vs Appium：Agent Device 移动应用自动化工具 和 Appium 的区别在于各自定位不同。下表展示主要差异：
| 项目 | 特点 |
|---|---|
| Appium | 老牌移动测试框架，但不原生支持 AI 代理 |
| Maestro | 轻量但无 MCP 集成 |
| Detox | React Native 专用但无 iOS Runner |
GitHub项目开源地址：https://github.com/callstack/agent-device