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

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

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

如何使用

在功能实现后，指示您的 AI 助手在其 MCP 客户端环境中使用可用的工具。例如，在 Cursor 的代理模式下，您可以使用以下提示快速验证和记录 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 工具 (参见安装指南)

安装

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

与 Cursor 集成

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

选项 1：使用 NPX（推荐）

1. 编辑您的 Cursor MCP 配置文件。您可以直接从 Cursor 打开它，或使用如下命令：

   # 使用默认编辑器打开（或使用 'code', 'vim' 等）
   open ~/.cursor/mcp.json
   # 或使用 Cursor 的命令（如果可用）
   # cursor ~/.cursor/mcp.json
   

2. 添加或更新 mcpServers 部分，配置 iOS 模拟器服务器：

   {
     "mcpServers": {
       // ... 这里可能列出了其他服务器 ...
       "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": {
       // ... 这里可能列出了其他服务器 ...
       "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 会话。

许可证

MIT