基本能力
产品定位
mcp-server-simulator-ios-idb 是一个桥接大型语言模型 (LLMs) 和 iOS 模拟器的服务,通过自然语言命令实现对模拟器的全面控制。
核心功能
- 模拟器控制:创建和管理模拟器会话,启动、关闭和监控模拟器状态,列出可用和运行的模拟器,聚焦模拟器窗口。
- 应用管理:安装和管理 iOS 应用程序,启动、终止和卸载应用,监控应用状态和验证安装,处理应用权限和配置。
- UI 交互与测试:与模拟器 UI 交互,执行点击、滑动和按钮按压操作,输入文本和按键序列,访问无障碍元素进行 UI 测试,录制 UI 交互视频。
- 开发与调试:捕获屏幕截图和系统日志,实时调试应用程序,监控和分析崩溃日志,安装动态库和管理应用数据。
- 高级功能:包括位置模拟、媒体注入、URL 方案处理、联系人数据库管理和钥匙串操作。
适用场景
- 自动化测试:通过自然语言命令自动化 iOS 应用的 UI 测试。
- 开发调试:在开发过程中快速调试和监控应用行为。
- 教育与演示:用于教学或演示 iOS 应用的功能和交互。
- 研究与实验:用于研究自然语言处理与设备控制的结合应用。
工具列表
- IDBManager:低层组件,直接通过 idb 与 iOS 模拟器交互。
- NLParser:解释自然语言指令并将其转换为结构化命令。
- MCPOrchestrator:协调解析器和 IDBManager 之间的交互。
常见问题解答
- 依赖问题:确保 macOS、Node.js、Homebrew 和 XCode 已正确安装。
- 安装问题:使用 Cline 或手动安装时,确保虚拟环境已激活。
- 命令执行问题:检查模拟器状态和应用是否已正确安装。
使用教程
使用依赖
- macOS:必需,用于支持 iOS 模拟器。
- Node.js:v14.0.0 或更高版本。
- Homebrew:用于安装依赖项。
- XCode:已安装 iOS 模拟器。
安装教程
- 通过 Cline 安装:
Add this mcp to cline https://github.com/InditexTech/mcp-server-simulator-ios-idb
- 手动安装:
bash
git clone https://github.com/InditexTech/mcp-server-simulator-ios-idb.git
cd mcp-server-simulator-ios-idb
python3 -m venv venv
source venv/bin/activate
npm install
npm run build
npm start
npm test
调试方式
- 启动服务:
bash
npm start - 测试命令:
bash
npm test - 检查日志:查看控制台输出以确认服务运行状态。