iOS模拟器MCP服务器

一个用于与iOS模拟器交互的模型上下文协议（MCP）服务器。该服务器允许您通过获取模拟器信息、控制UI交互以及检查UI元素来与iOS模拟器进行交互。

安全提示：版本<1.3.3中存在的命令注入漏洞已修复。请更新至v1.3.3或更高版本。详情请参阅SECURITY.md。

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

功能

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

配置

环境变量

IOS_SIMULATOR_MCP_FILTERED_TOOLS：要过滤掉的已注册工具名称的逗号分隔列表。例如：screenshot,record_video,stop_recording

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

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

如何使用

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

示例提示

验证UI元素：

验证当前屏幕上的所有辅助功能元素

确认文本输入：

将"QA Test"输入到文本输入字段并确认输入正确

检查点击响应：

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

验证滑动操作：

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

详细元素检查：

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

向您的AI代理展示模拟器屏幕：
```
查看当前模拟器屏幕
```

截图：

对当前模拟器屏幕进行截图并保存到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（推荐）

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

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

添加或更新mcpServers部分，包含iOS模拟器服务器的配置：

{
  "mcpServers": {
    // ... 这里可能列出了其他服务器 ...
    "ios-simulator": {
      "command": "npx",
      "args": ["-y", "ios-simulator-mcp"]
    }
  }
}

确保JSON结构有效，特别是如果mcpServers已存在。

重启Cursor使更改生效。

选项2：本地开发

克隆此仓库：

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

安装依赖：
```
npm install
```
构建项目：
```
npm run build
```
编辑您的Cursor MCP配置文件（如选项1所示）。

添加或更新mcpServers部分，指向您的本地构建：

{
  "mcpServers": {
    // ... 这里可能列出了其他服务器 ...
    "ios-simulator": {
      "command": "node",
      "args": ["/full/path/to/your/ios-simulator-mcp/build/index.js"]
    }
  }
}

重要提示：将/full/path/to/your/替换为您克隆的ios-simulator-mcp仓库的绝对路径。

重启Cursor使更改生效。

与Claude Code集成

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

选项1：使用NPX（推荐）

使用claude mcp add命令添加服务器：

claude mcp add ios-simulator npx ios-simulator-mcp

如有必要，重启任何正在运行的Claude Code会话。

选项2：本地开发

克隆此仓库，安装依赖并构建项目，如Cursor的"本地开发"步骤1-3所述。
使用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仓库的绝对路径。
如有必要，重启任何正在运行的Claude Code会话。

许可证

MIT

joshuayoes/ios-simulator-mcp

星标增长

证据时间轴

iOS模拟器MCP服务器

功能

配置

环境变量

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

如何使用

示例提示

前置条件

安装

与Cursor集成

选项1：使用NPX（推荐）

选项2：本地开发

与Claude Code集成

选项1：使用NPX（推荐）

选项2：本地开发

许可证