iOS Simulator MCP

iOS 模拟器 MCP 服务器

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

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

💡 用例：通过 MCP 工具调用进行 QA 步骤

此 MCP 服务器允许集成模型上下文协议 (MCP) 客户端的 AI 助手通过调用工具来执行质量保证任务。此功能在功能实现后立即可用，有助于确保 UI 一致性和正确行为。

如何使用

功能实现后，请在 MCP 客户端环境中指导您的 AI 助手使用可用的工具。例如，在 Cursor 的代理模式下，您可以使用以下提示快速验证和记录 UI 交互。

示例提示

• 验证 UI 元素：
  Verify all accessibility elements on the current screen
• 确认文本输入：
  Enter "QA Test" into the text input field and confirm the input is correct
• 检查点击响应：
  Tap on coordinates x=250, y=400 and verify the expected element is triggered
• 验证滑动操作：
  Swipe from x=150, y=600 to x=150, y=100 and confirm correct behavior
• 详细元素检查：
  Describe the UI element at position x=300, y=350 to ensure proper labeling and functionality
• 截屏：
  Take a screenshot of the current simulator screen and save it to my_screenshot.png
• 录制视频：
  Start recording a video of the simulator screen (saves to ~/Downloads/simulator_recording_$DATE.mp4 by default)
• 停止录制：
  Stop the current simulator screen recording

先决条件

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

安装

本节提供将 iOS 模拟器 MCP 服务器与不同的模型上下文协议 (MCP) 客户端集成的说明。

使用光标安装

Cursor 通过位于~/.cursor/mcp.json配置文件来管理 MCP 服务器。

选项 1：使用 NPX（推荐）

1. 编辑 Cursor MCP 配置文件。您可以直接从 Cursor 打开它，或者使用以下命令：
   # Open with your default editor (or use 'code', 'vim', etc.) open ~/.cursor/mcp.json # Or use Cursor's command if available # cursor ~/.cursor/mcp.json
2. 使用 iOS 模拟器服务器配置添加或更新mcpServers部分：
   { "mcpServers": { // ... other servers might be listed here ... "ios-simulator": { "command": "npx", "args": ["-y", "ios-simulator-mcp"] } } }
   确保 JSON 结构有效，尤其是当mcpServers已经存在时。
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 配置文件（如选项 1 所示）。
5. 添加或更新mcpServers部分，指向您的本地构建：
   { "mcpServers": { // ... other servers might be listed here ... "ios-simulator": { "command": "node", "args": ["/full/path/to/your/ios-simulator-mcp/build/index.js"] } } }
   **重要提示：**将/full/path/to/your/替换为您克隆ios-simulator-mcp存储库的绝对路径。
6. 重新启动 Cursor 以使更改生效。

与 Claude Code 一起安装

Claude Code CLI 可以使用claude mcp命令或直接编辑其配置文件来管理 MCP 服务器。有关 Claude Code MCP 配置的更多详细信息，请参阅官方文档。

选项 1：使用 NPX（推荐）

1. 使用claude mcp add命令添加服务器：
   claude mcp add ios-simulator --command npx --args "-y,ios-simulator-mcp"
   注意： --args参数采用单个逗号分隔的字符串。
2. 如有必要，重新启动任何正在运行的 Claude Code 会话。

选项 2：本地开发

1. 克隆此存储库，安装依赖项，并按照 Cursor“本地开发”步骤 1-3 中所述构建项目。
2. 使用claude mcp add命令添加服务器，指向您的本地构建：
   claude mcp add ios-simulator --command node --args "/full/path/to/your/ios-simulator-mcp/build/index.js"
   **重要提示：**将/full/path/to/your/替换为您克隆ios-simulator-mcp存储库的绝对路径。
3. 如有必要，重新启动任何正在运行的 Claude Code 会话。

执照

麻省理工学院