iOS Simulator MCP Server

社区

通过 MCP 操作和检查 iOS 模拟器。

分类: 开发工具第 176 / 438
Stars: ★ 2.2k 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js · 预编译二进制
凭据: 无需凭据
许可证: MIT
最近提交: 2 个月前
工具数: 14

56FMRS · C

资料显示该服务器专注于 macOS 上的 iOS 模拟器交互、UI 自动化、可访问性检查、截图录像及应用安装启动。README 提供 Cursor 和 Claude Code 的 stdio 配置示例。未提供主题、服务器清单、认证机制或其他传输方式信息。

最强项 · 文档质量 15/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

10/20

维护活跃度

10/20

文档质量

15/20

安装易用性

13/20

查看各项评分依据

可靠性 8/20: README列出了工具、参数和依赖，正常路径看起来可行；但服务器清单未缓存，未提供可审查的初始化握手、工具列表一致性、测试、CI或错误处理证据。IDB、Xcode和macOS依赖也可能导致启动或运行失败，因此扣分。
安全与权限 10/20: 功能主要限定在本机iOS模拟器交互、应用安装、截图和录像，未显示凭据处理或外部网络传输；UDID和输出路径可配置。安全公告称1.3.3之前存在命令注入漏洞，但安装示例未固定到安全版本，且缺少权限边界、路径校验和危险操作确认证据，因此扣分。
维护活跃度 10/20: 项目未归档，使用MIT许可证，并在README中提供安全公告引用，显示存在维护和授权基础；但提示材料没有发布记录、提交活动、问题响应、依赖更新或明确安全响应渠道，且存在31个开放问题，因此不能给高分。
文档质量 15/20: README覆盖工具用途、全部参数、环境变量、前置依赖、Cursor和Claude Code安装方式、示例及平台限制；但缺少服务器清单、可验证运行证据、系统化故障排查、错误语义、版本锁定和更完整的安全/数据边界说明，因此扣分。
安装易用性 13/20: 提供了NPX和本地构建两种路径，并包含Cursor与Claude Code配置示例，步骤基本完整；但必须使用macOS、Xcode/iOS模拟器和Facebook IDB，仍需手动配置和重启，且没有文件级执行验证或版本固定，因此扣分。

静态评测 · 未实际运行收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么写入 / 删除本地文件执行命令或代码控制浏览器

适合谁

使用 macOS、Xcode 和 iOS 模拟器进行开发或 QA 的团队
需要通过 MCP 让 AI 助手执行移动端 UI 验证的用户
需要检查 iOS 可访问性树和界面响应的开发者

不适合谁

没有 macOS、Xcode 或 iOS 模拟器的环境
需要真实 iOS 设备测试的场景
不需要模拟器控制、检查或应用安装的任务

所需权限

需要访问 macOS 上的 iOS 模拟器和 Xcode 工具。
需要使用 Facebook IDB；默认从 PATH 中查找 idb，也可通过 IOS_SIMULATOR_MCP_IDB_PATH 指定路径。
截图和视频功能需要写入输出目录；默认目录为 ~/Downloads，也可通过 IOS_SIMULATOR_MCP_DEFAULT_OUTPUT_DIR 配置。
安装应用和启动应用需要目标应用路径或 bundle identifier。

风险与副作用

ui_tap、ui_type、ui_swipe、install_app 和 launch_app 会改变模拟器状态或应用状态。
截图和视频可能保存模拟器屏幕内容到本地文件。
版本低于 1.3.3 存在命令注入漏洞；README 声明该问题已修复，建议更新到 1.3.3 或更高版本。
文本输入仅支持 ASCII 可打印字符。

安装接入

准备工作

运行环境：Node.js · 预编译二进制

其他可选配置项（4 个）

IOS_SIMULATOR_MCP_FILTERED_TOOLS 可选可选，逗号分隔的工具名列表，用于从注册中过滤掉指定工具。

IOS_SIMULATOR_MCP_DEFAULT_OUTPUT_DIR 可选可选，指定截图和视频的默认输出目录；未设置时使用 ~/Downloads。

IOS_SIMULATOR_MCP_IDB_PATH 可选可选，指定 IDB 可执行文件的自定义路径；未设置时假定 idb 在 PATH 中。

IDB_UDID 可选可选，作为各工具 udid 参数的环境变量替代，用于指定目标模拟器。

需要 Node.js、macOS、已安装的 Xcode 和 iOS 模拟器，以及 Facebook IDB。使用 npx 配置：在 Cursor 的 ~/.cursor/mcp.json 中加入提供的 mcpServers 配置并重启 Cursor；或运行 claude mcp add ios-simulator npx ios-simulator-mcp。也可以克隆仓库、运行 npm install 和 npm run build，然后使用本地 build/index.js 配置。

.cursor/mcp.json

{"mcpServers":{"ios-simulator":{"command":"npx","args":["-y","ios-simulator-mcp"]}}}

以 Cursor 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "ios-simulator": {
      "command": "npx",
      "args": [
        "-y",
        "ios-simulator-mcp"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

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

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端的工具列表中应出现 ios-simulator 服务器的工具（如 get_booted_sim_id、ui_tap、screenshot 等），或调用 get_booted_sim_id 能返回已启动模拟器的 ID。

常见排障

确认运行环境为 macOS，并已安装 Xcode 和所需的 iOS 模拟器。
确认 IDB 已安装并可执行；若不在 PATH 中，检查 IOS_SIMULATOR_MCP_IDB_PATH。
使用 get_booted_sim_id 确认当前已启动的模拟器，并在需要时通过 udid 指定目标。
检查 IOS_SIMULATOR_MCP_DEFAULT_OUTPUT_DIR 是否指向可写目录。
如果工具未注册，检查 IOS_SIMULATOR_MCP_FILTERED_TOOLS 是否过滤了相关工具，并重启 MCP 客户端。
确认使用的 npm 包版本至少为 1.3.3。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

验证当前屏幕上的所有无障碍元素
在坐标 x=250, y=400 处点击并确认触发了预期的元素
截取当前模拟器屏幕并保存为 my_screenshot.png
在模拟器上启动 Safari 应用（com.apple.mobilesafari）

工具能力 14

get_booted_sim_id 只读

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

open_simulator 写入

打开 iOS 模拟器应用。

ui_describe_all 只读

描述 iOS 模拟器整个屏幕的可访问性信息。

ui_tap 写入

点击 iOS 模拟器屏幕上的指定坐标。

ui_type 写入

向 iOS 模拟器输入文本。

ui_swipe 写入

在 iOS 模拟器屏幕上执行滑动操作。

ui_describe_point 只读

返回 iOS 模拟器屏幕指定坐标处的可访问性元素。

ui_find_element 只读

在可访问性树中搜索符合条件的元素。

展开其余 6 个工具

ui_view 只读

获取当前模拟器视图的压缩截图图像内容。

screenshot 写入

截取 iOS 模拟器屏幕并保存到指定路径。

record_video 写入

使用 simctl 录制 iOS 模拟器视频。

stop_recording 写入

停止当前的模拟器视频录制。

install_app 写入

在 iOS 模拟器上安装 .app 或 .ipa 应用。

launch_app 写入

通过 bundle identifier 启动 iOS 模拟器上的应用。

使用场景

功能实现后的 UI 一致性和行为验证

检查模拟器当前屏幕的可访问性元素

执行点击、文本输入和滑动操作

查看或保存模拟器截图

录制模拟器视频

在模拟器上安装并启动应用

支持客户端

Cursor

Claude Code

依据项目文档列出，未经本站实测。

详细介绍

iOS Simulator MCP Server 是一个用于与 iOS 模拟器交互的 MCP 服务器，支持获取模拟器信息、控制界面、检查可访问性元素、查看和保存屏幕内容、录制视频，以及安装和启动应用。服务器路径为仓库根目录，采用 MIT 许可证。