iOS模拟器MCP服务器

一款用于与iOS模拟器交互的Model Context Protocol (MCP)服务器。该服务器支持通过获取模拟器信息、控制UI交互和检查UI元素来实现与iOS模拟器的交互。

核心功能

1. 获取模拟器状态

   • 获取当前已启动的iOS模拟器ID

2. UI交互控制

   • 无障碍元素分析：描述屏幕上所有可访问性元素
   • 坐标操作：
     • 点击屏幕指定坐标（x, y）
     • 在坐标间执行滑动操作
   • 文本输入：向输入框输入文本
   • 元素查询：获取指定坐标处的UI元素信息
   • 截图与录制：
     • 截取模拟器屏幕快照
     • 录制屏幕操作视频（需手动启动/停止）

3. 工具过滤

   • 通过环境变量过滤指定工具（如禁用截图或录制功能）

配置与环境变量

环境变量

IOS_SIMULATOR_MCP_FILTERED_TOOLS

• 作用：按逗号分隔的工具名称列表，用于过滤不希望注册的工具
• 示例：

                      
  bash
  
                      # 禁用截图和视频录制工具  
  IOS_SIMULATOR_MCP_FILTERED_TOOLS="screenshot,record_video,stop_recording"  
  

使用场景：基于MCP工具调用的QA流程

该MCP服务器可与MCP客户端（如Cursor）集成，通过AI助手执行质量保证（QA）任务，验证UI一致性和功能正确性。

使用指南

示例提示词（以Cursor的Agent模式为例）

1. 验证UI元素

   Verify all accessibility elements on the current screen  
   

2. 确认文本输入

   Enter "QA Test" into the text input field and confirm the input is correct  
   

3. 检查点击响应

   Tap on coordinates x=250, y=400 and verify the expected element is triggered  
   

4. 验证滑动操作

   Swipe from x=150, y=600 to x=150, y=100 and confirm correct behavior  
   

5. 详细元素检查

   Describe the UI element at position x=300, y=350 to ensure proper labeling and functionality  
   

6. 截图与录制

   Take a screenshot of the current simulator screen and save it to my_screenshot.png  
   Start recording a video of the simulator screen  
   Stop the current simulator screen recording  
   

前置条件

1. 系统要求：
   • macOS（仅支持在macOS上运行iOS模拟器）
   • 已安装Xcode及iOS模拟器
2. 工具依赖：
   • Node.js（运行服务器）
   • Facebook IDB工具（用于与模拟器通信，安装指南）

注意事项

• 权限要求：需确保Xcode和IDB工具已正确配置，且模拟器处于运行状态。
• 坐标系统：屏幕坐标以模拟器窗口左上角为原点（x=0, y=0）。
• 视频录制路径：默认保存至~/Downloads/simulator_recording_$DATE.mp4，可通过配置修改存储位置。

通过集成该服务器，开发者和QA团队可借助AI自动化验证iOS应用的UI交互逻辑，提升测试效率和准确性。