AI导哈

iOS设备控制工具

一个用于自动化控制iOS模拟器和真实设备的MCP服务器，支持通过LLMs（如Claude）与iOS设备交互。

  • by sunghyun-k
  • Swift
  • 本地部署
  • 12 星标
  • 更新于
在 GitHub 查看 sunghyun-k/ios-control-mcp

使用说明

ios控制mcp

韩语

用于自动化iOS模拟器和真实iOS设备的MCP（模型上下文协议）服务器。使Claude等LLM能够与iOS设备交互。

https://github.com/user-attachments/assets/4284357b-6b6e-4e6a-a81c-e5976052be51

快速开始

30秒后开始：

  1. 添加到MCP客户端配置中：

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

  2. 问克劳德： “截取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-mcp
Claude 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.准备您的设备

  1. 启用开发人员模式：设置→ 隐私和安全→ 开发者模式→ 启用（iOS 16+）
  2. 通过USB连接：通过USB将设备连接到Mac，并在提示时点击“信任”
  3. 首次运行：安装应用程序后，如果您看到“Untrusted Developer”警告，请转到“设置”→ 将军→ VPN和设备管理，信任开发者应用程序

使用示例

以下是一些你可以问克劳德的问题：

截图和UI检查：

“截取当前屏幕的屏幕截图” “显示UI快照”

应用程序导航：

“打开设置应用程序” “启动Safari”

UI交互：

“点击“登录”按钮” “类型”hello@example.com'在电子邮件字段中“ “向上滑动”

许可证

麻省理工学院

相关 MCP