iOS 模拟器 MCP 服务器

这是一个用于与 iOS 模拟器交互的 Model Context Protocol (MCP) 服务器。该服务器允许您通过获取有关模拟器的信息、控制 UI 交互和检查 UI 元素来与 iOS 模拟器进行交互。

https://github.com/user-attachments/assets/453ebe7b-cc93-4ac2-b08d-0f8ac8339ad3

功能

• 获取当前启动的 iOS 模拟器的 ID
• 与模拟器 UI 交互：
  • 描述屏幕上的所有可访问性元素
  • 点击屏幕坐标
  • 输入文本
  • 在坐标之间滑动
  • 获取特定坐标的 UI 元素信息
  • 截取模拟器屏幕的截图

💡 使用案例：代理模式下的 QA 步骤

此 MCP 可以在代理模式下有效用作功能实现后的质量保证步骤，确保 UI 的一致性和正确行为。

如何使用

在功能实现后：

1. 在 Cursor 中激活代理模式。
2. 使用以下提示快速验证并记录 UI 交互。

示例提示

• 验证 UI 元素：

  验证当前屏幕上所有的可访问性元素
  

• 确认文本输入：

  在文本输入框中输入 "QA Test" 并确认输入正确
  

• 检查点击响应：

  点击坐标 x=250, y=400 并验证预期的元素被触发
  

• 验证滑动操作：

  从 x=150, y=600 滑动到 x=150, y=100 并确认正确的行为
  

• 详细元素检查：

  描述位置 x=300, y=350 的 UI 元素以确保正确的标签和功能
  

• 截取屏幕：

  截取当前模拟器屏幕并保存为 my_screenshot.png
  

• 录制视频：

  开始录制模拟器屏幕（默认保存到 ~/Downloads/simulator_recording_$DATE.mp4）
  

• 停止录制：

  停止当前模拟器屏幕录制
  

前提条件

• Node.js
• macOS（因为 iOS 模拟器仅在 macOS 上可用）
• Xcode 和已安装的 iOS 模拟器
• Facebook IDB 工具 (查看安装指南)

安装

选项 1：使用 NPX（推荐）

1. 编辑您的 Cursor MCP 配置：

   cursor ~/.cursor/mcp.json
   

2. 将 iOS 模拟器服务器添加到您的配置中：

   {
     "mcpServers": {
       "ios-simulator": {
         "command": "npx",
         "args": ["-y", "ios-simulator-mcp"]
       }
     }
   }
   

3. 重启 Cursor。

选项 2：本地开发

1. 克隆此仓库：

   git clone https://github.com/joshuayoes/ios-simulator-mcp
   cd ios-simulator-mcp
   

2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

4. 编辑你的 Cursor MCP 配置：

   cursor ~/.cursor/mcp.json
   

5. 将 iOS 模拟器服务器添加到你的配置中：

   {
     "mcpServers": {
       "ios-simulator": {
         "command": "node",
         "args": ["/path/to/your/ios-simulator-mcp/build/index.js"]
       }
     }
   }
   

   请将 "/path/to/your" 替换为你实际的项目目录路径。

6. 重启 Cursor。

许可证

MIT