iOS 模拟器 MCP 服务器

一个用于与 iOS 模拟器交互的模型上下文协议 (MCP) 服务器。 此服务器允许您通过获取有关它们的信息、控制 UI 交互和检查 UI 元素来与 iOS 模拟器进行交互。

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

特性

• 获取当前启动的 iOS 模拟器的 ID
• 与模拟器 UI 交互：
  • 描述屏幕上的所有辅助功能元素
  • 点击屏幕坐标
  • 输入文本
  • 在坐标之间滑动
  • 获取有关特定坐标处 UI 元素的信息
  • 截取模拟器屏幕的屏幕截图
• 使用环境变量过滤特定工具

配置

环境变量

• IOS_SIMULATOR_MCP_FILTERED_TOOLS: 一个逗号分隔的工具名称列表，用于过滤掉不被注册的工具。 例如：screenshot,record_video,stop_recording

💡 用例：代理模式下的 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