bridge4simulator
AppGram/bridge4simulator加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。

bridge4simulator 让 AI 助手直接控制 iOS Simulator,完成从 UI 导航到应用安装的全流程操作
每一位 iOS 开发者都曾被这个问题困扰:每次想验证一个 UI 效果,都得在 Xcode 里手动点开 Simulator,找到对应设备,再一步步操作——光是启动 App 就要点五六下。 如果能直接用自然语言描述"打开日历 App,找到下周三,在 14:00 创建一个会议",让 AI 替你完成这一切,该有多好?
bridge4simulator 正是来解决这个痛点的。它是一个 MCP(Model Context Protocol)服务器,通过 MCP 协议连接 AI 助手(如 Claude Desktop、Cursor、Claude Code)和 iOS Simulator,让 AI 获得直接操控模拟器的能力——点击、滑动、打字、截屏、OCR 识别 UI 元素,全程无需人工介入。
这个项目的作者是 AppGram(一家专注 iOS 工具开发的团队),他们将这个工具定位为"AI 原生 iOS 测试框架"——不是给人用的辅助工具,而是给 AI Agent 用的执行层。
MCP(Model Context Protocol)是 Anthropic 在 2024 年底推出的开放协议,类似于 AI 工具生态中的"USB-C 接口"——它定义了 AI 如何调用外部工具的标准方式,工具开发者只需实现一次,就能对接所有支持 MCP 的 AI 客户端。
bridge4simulator 基于 MCP 实现了 21 个工具,分为 6 大类:
| 类别 | 工具 | 功能说明 |
|---|---|---|
| 设备管理 | device_list、device_boot、device_shutdown、status | 列出、启动、关闭模拟器设备 |
| 输入控制 | tap、swipe、type_text | 模拟触控手势和文字输入 |
| 屏幕捕获 | screenshot、record_start、record_stop | 截屏和录制操作过程 |
| 应用管理 | app_install、app_launch、app_terminate | 安装、启动、终止 App |
| UI 交互 | ui_describe、ui_find、ui_search、ui_summary、ui_point、ui_ocr | 读取屏幕元素、OCR 识别、查找 UI 节点 |
| 宏录制 | macro_play、macro_list | 保存和回放操作序列 |
技术亮点:内置的 ui_describe 和 ui_ocr 工具利用了苹果的 Accessibility 框架和 OCR 能力,在极低的 token 消耗下完成 UI 理解,比直接截图让 AI 视觉分析节省 90% 以上的上下文长度。
方式一:Homebrew(推荐)
brew tap AppGram/tap
brew install bridge4simulator
bridge4simulator --version
方式二:一键安装脚本
curl -fsSL https://github.com/AppGram/bridge4simulator/releases/latest/download/install.sh | bash
支持 Apple Silicon(M1-M5)和 Intel Mac,提供 .zip 预编译包。
在 Claude Desktop / Cursor / Claude Code 的 MCP 配置中添加:
{
"mcpServers": {
"bridge4simulator": {
"command": "/usr/local/bin/bridge4simulator",
"args": ["mcp", "--enable-tools=screenshot"]
}
}
}
注意:Claude Desktop 在本地开发模式下不支持 HTTP URL,需要使用命令行路径方式。
xcode-select --install场景 1:AI 驱动的 UI 测试
"启动 iOS Simulator,安装我开发的 App,截屏看看登录界面长什么样"
AI 自动完成:启动设备 → 安装 .ipa → 打开 App → 截图 → 返回分析结果。
场景 2:自动化操作流
"打开 Apple Maps,设置从罗马到帕多瓦的火车路线导航"
AI 自主完成:打开地图 App → 输入起点终点 → 选择火车选项 → 截图确认结果。YouTube 视频演示中,AI 完整执行了从罗马到帕多瓦的路线规划操作。
场景 3:批量回归测试
"每天自动启动多个 iOS 版本模拟器,安装 App 并截图对比兼容性"
通过 macro_play 回放录制好的操作序列,结合循环脚本实现自动化。
平台锁死 macOS:这是一个 macOS 原生二进制工具,不支持 Linux/Windows,无法用 Docker 部署。核心依赖 Xcode + iOS Simulator 环境,跨平台需求无法满足。
闭源商业工具:项目采用闭源许可,底层依赖一个商业化工具(contact: nedim@nfxai.io)。在生产环境中使用需评估商业许可条款。
需要物理设备环境:UI 自动化工具依赖真实 iOS Simulator,无法在纯云端/CI 环境中运行(除非使用 macOS 云主机)。
版本更新较快:目前最新版本为 v1.0.2(2026年1月),API 和工具集仍在迭代,使用前需关注 Changelog。
bridge4simulator 代表的趋势是 AI Agent 的工具层扩展。过去一年,MCP 生态从 Claude 独家的内部协议演变为开放标准,bridge4simulator 填补了"AI 控制移动端模拟器"这一空白赛道。
目前 GitHub 上类似的 MCP Server 主要集中在数据库、文件系统、Web 浏览器等领域,移动端工具类 MCP 非常稀缺。81 星的关注量对于一个 2025 年底才发布的垂直工具来说,增长曲线值得持续关注。
从技术演进角度看,当 AI Agent 能稳定操控 iOS Simulator,意味着AI 原生的移动端测试框架成为可能——不再需要人肉点点点,AI 自己设计测试用例、自己执行、自己分析截图结果。