📱 MCP Server for iOS Simulator

基本能力

产品定位

MCP Server for iOS Simulator 是一个桥梁服务，连接 iOS 模拟器和 Model Context Protocol，实现标准化通信和程序化控制。

核心功能

• 🚀 启动、停止和管理 iOS 模拟器实例
• 🔌 启动和关闭模拟器
• 📲 安装和启动应用程序
• 📸 截取模拟器屏幕截图
• 👆 在指定坐标执行点击操作
• 🔄 支持多个并发模拟器会话
• 📝 全面的文件日志记录
• 🛡️ 错误恢复操作

适用场景

• 开发者在开发过程中需要自动化控制 iOS 模拟器
• 测试人员需要自动化测试 iOS 应用程序
• 需要与 MCP 兼容客户端集成的场景

工具列表

• 直接模拟器管理工具
• list-available-simulators - 列出所有可用模拟器及其 UDID
• boot-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+

安装教程

# 克隆仓库
git clone https://github.com/atom2ueki/mcp-server-ios-simulator.git
cd mcp-server-ios-simulator

# 安装依赖
npm install

调试方式

# 构建项目
npm run build

# 启动服务器
npm start

配置 Claude Desktop 使用该服务器作为 MCP 工具，具体配置请参考 README 中的示例。

许可证

该项目遵循 MIT 开源许可条款。