ios控制mcp
用于自动化iOS模拟器和真实iOS设备的MCP（模型上下文协议）服务器。使Claude等LLM能够与iOS设备交互。
https://github.com/user-attachments/assets/4284357b-6b6e-4e6a-a81c-e5976052be51
快速开始
30秒后开始：
- 添加到MCP客户端配置中：
{
"mcpServers": {
"ios-control": {
"command": "npx",
"args": ["-y", "ios-control-mcp"]
}
}
}- 问克劳德： *“截取iOS模拟器的屏幕截图”*
就是这样！Claude现在可以控制iOS模拟器了。看 安装 有关详细的设置说明。
特性
设备管理
- 列表_设备 -列出已连接的iOS设备（模拟器和物理设备）
- select_device -通过UDID选择要控制的设备
屏幕信息
- get_ui_snapshot -获取所有前台应用的UI元素树
- 截图 -截取当前屏幕的屏幕截图
UI交互
- 轻敲 -点击UI元素的标签
- 类型文本 -键入文本（可选地输入特定元素）
- 滑动 -向某个方向滑动
- 拖拽 -通过标签从一个元素拖动到另一个元素
应用程序和设备控制
- launch_app -按捆绑包ID启动应用程序
- 按下按钮 -按下硬件按钮（主页、音量向上、音量向下）
需求
- macOS 13或更高版本
- Xcode（带iOS模拟器）
- Node.js 18或更高版本
- 对于物理设备：Apple开发者团队ID（免费或付费）
安装
使用模拟器（默认）
模拟器无需额外设置即可开箱即用。
标准配置 -适用于大多数MCP客户端：
{
"mcpServers": {
"ios-control": {
"command": "npx",
"args": [
"-y",
"ios-control-mcp"
]
}
}
}Claude Code
claude mcp add ios-control -- npx -y ios-control-mcp对于物理设备，添加Team ID环境变量：
claude mcp add ios-control -e IOS_CONTROL_TEAM_ID=YOUR_TEAM_ID -- npx -y ios-control-mcpClaude Desktop
跟随 MCP安装指南 使用上面的标准配置。
Cursor
首选 Cursor Settings → MCP → Add new MCP Server。设置名称并输入 npx -y ios-control-mcp 作为命令类型。
VS Code
通过VS Code CLI安装：
code --add-mcp '{"name":"ios-control","command":"npx","args":["-y","ios-control-mcp"]}'或者跟随 MCP安装指南 使用上面的标准配置。
Windsurf
跟随 Windsurf MCP文件 使用上面的标准配置。
使用物理iOS设备
使用物理iOS设备需要Apple开发团队ID。免费的Apple ID也可以使用。
1.查找您的团队ID
在终端中运行此命令以查找您的团队ID：
security find-identity -v -p codesigning输出示例：
1) ABCDEF1234567890... "Apple Development: your@email.com (XXXXXXXXXX)"括号中的10个字符串（例如。， XXXXXXXXXX)是您的团队ID。
没有团队ID？ 在Xcode中打开任何项目，使用您的Apple ID登录，然后构建到设备上一次。这将自动生成团队ID。
2.将团队ID添加到MCP配置中
{
"mcpServers": {
"ios-control": {
"command": "npx",
"args": ["-y", "ios-control-mcp"],
"env": {
"IOS_CONTROL_TEAM_ID": "YOUR_TEAM_ID"
}
}
}
}3.准备您的设备
- 启用开发人员模式：设置→ 隐私和安全→ 开发者模式→ 启用（iOS 16+）
- 通过USB连接：通过USB将设备连接到Mac，并在提示时点击“信任”
- 首次运行：安装应用程序后，如果您看到“Untrusted Developer”警告，请转到“设置”→ 将军→ VPN和设备管理，信任开发者应用程序
使用示例
以下是一些你可以问克劳德的问题：
截图和UI检查：
“截取当前屏幕的屏幕截图” “显示UI快照”
应用程序导航：
“打开设置应用程序” “启动Safari”
UI交互：
“点击“登录”按钮” “类型”hello@example.com'在电子邮件字段中“ “向上滑动”
许可证
麻省理工学院