iOS 模拟器 MCP 服务器

NPM 版本

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

特征

Related MCP server: iOS simulators MCP

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

此 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

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

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

编辑 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
使用 iOS 模拟器服务器配置添加或更新mcpServers部分：
{ "mcpServers": { // ... other servers might be listed here ... "ios-simulator": { "command": "npx", "args": ["-y", "ios-simulator-mcp"] } } }
确保 JSON 结构有效，尤其是当mcpServers已经存在时。
重新启动 Cursor 以使更改生效。

克隆此存储库：
git clone https://github.com/joshuayoes/ios-simulator-mcp cd ios-simulator-mcp
安装依赖项：
npm install
构建项目：
npm run build
编辑您的 Cursor MCP 配置文件（如选项 1 所示）。
添加或更新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存储库的绝对路径。
重新启动 Cursor 以使更改生效。

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

使用claude mcp add命令添加服务器：
claude mcp add ios-simulator --command npx --args "-y,ios-simulator-mcp"
注意：
如有必要，重新启动任何正在运行的 Claude Code 会话。

克隆此存储库，安装依赖项，并按照 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 会话。