基本能力
产品定位
MCP Server for iOS Simulator 是一个桥梁服务，连接 iOS 模拟器和 Model Context Protocol，实现标准化通信和程序化控制。
核心功能
- 🚀 启动、停止和管理 iOS 模拟器实例
- 🔌 启动和关闭模拟器
- 📲 安装和启动应用程序
- 📸 截取模拟器屏幕截图
- 👆 在指定坐标执行点击操作
- 🔄 支持多个并发模拟器会话
- 📝 全面的文件日志记录
- 🛡️ 错误恢复操作
适用场景
- 开发者在开发过程中需要自动化控制 iOS 模拟器
- 测试人员需要自动化测试 iOS 应用程序
- 需要与 MCP 兼容客户端集成的场景
工具列表
- 直接模拟器管理工具
list-available-simulators- 列出所有可用模拟器及其 UDIDboot-simulator-by-udid- 通过 UDID 启动模拟器shutdown-simulator-by-udid- 通过 UDID 关闭模拟器-
list-booted-simulators- 列出所有当前启动的模拟器 -
基于会话的管理工具
list-simulator-sessions- 列出所有活动模拟器会话create-simulator-session- 创建新模拟器会话terminate-simulator-session- 终止会话create-and-boot-simulator- 创建并启动新模拟器会话boot-simulator- 为现有会话启动模拟器-
shutdown-simulator- 为现有会话关闭模拟器 -
应用程序管理工具
install-app- 在模拟器上安装应用程序launch-app- 在模拟器上启动应用程序-
terminate-app- 终止模拟器上运行的应用程序 -
交互工具
take-screenshot- 截取模拟器屏幕截图tap-coordinate- 在指定坐标执行点击操作
常见问题解答
-
Q: 该服务需要哪些前置条件？
A: 需要 Node.js (v16 或更高版本)、macOS、Xcode 和 TypeScript 4.5+。 -
Q: 如何配置默认模拟器设备？
A: 通过设置环境变量SIMULATOR_DEFAULT_DEVICE和SIMULATOR_DEFAULT_OS来配置。
使用教程
使用依赖
确保满足以下前置条件：
- 🟢 Node.js (v16 或更高版本)
- 🍎 macOS (iOS 模拟器必需)
- 🛠️ 安装 Xcode 和 iOS 模拟器
- 📜 TypeScript 4.5+
安装教程
```bash
克隆仓库
git clone https://github.com/atom2ueki/mcp-server-ios-simulator.git
cd mcp-server-ios-simulator
安装依赖
npm install
```
调试方式
```bash
构建项目
npm run build
启动服务器
npm start
```
配置 Claude Desktop 使用该服务器作为 MCP 工具，具体配置请参考 README 中的示例。
