# 让 Claude、Codex 控制 iPhone，iOS MCP 来了

# 前言

AI 代理现在已经很擅长写代码、分析问题、执行流程了。
但在 iPhone 真机场景里，尤其是越狱设备上，很多能力依然是断开的：

- AI 能理解页面，但不能直接点屏幕
- AI 能生成脚本，但不能真正读取 UI 树
- AI 能提出建议，但不能帮你安装 IPA、启动 App、验证前台状态

所以我做了一个项目：**iOS MCP**。

它是一个运行在越狱 iPhone 上的 **MCP Server**，目标很直接：

> 让 Claude、Codex、Cursor 这类 AI，真正具备操作 iPhone 的能力。

---

# 一、iOS MCP 是什么

**iOS MCP** 是一个面向 AI 代理的 iPhone 真机控制层。

它把原本零散的能力统一成 MCP 工具，让 AI 可以直接完成：

- 点击、滑动、长按、双击、拖拽
- 输入文字、模拟按键
- 获取截图、读取 UI 元素树
- 安装 / 启动 / 卸载 App
- 获取前台 App、运行中 App、设备信息
- 调节亮度、音量、剪贴板
- 执行 Shell 命令

一句话理解：

> **iOS MCP = 给 AI 接上一只真正能控制 iPhone 的手。**

---

# 二、它能做什么

目前项目已经提供 **33 个 MCP 工具**，覆盖以下场景：

## 1、真机交互

- `tap_screen`
- `swipe_screen`
- `long_press`
- `double_tap`
- `drag_and_drop`

## 2、界面感知

- `screenshot`
- `get_screen_info`
- `get_ui_elements`
- `get_element_at_point`

## 3、App 管理

- `list_apps`
- `launch_app`
- `kill_app`
- `install_app`
- `uninstall_app`

## 4、输入与按键

- `input_text`
- `type_text`
- `press_key`
- `press_home`
- `press_power`

## 5、设备控制

- `get_device_info`
- `get_brightness`
- `set_brightness`
- `get_volume`
- `set_volume`
- `run_command`

---

# 三、它适合谁

我觉得这个项目比较适合：

- iOS 开发者
- 自动化测试工程师
- 越狱开发者
- 逆向工程师
- AI Agent 开发者
- 想把 AI 真正接入 iPhone 真机的人

如果你正在关注：

- iPhone 真机自动化
- AI + 越狱设备
- MCP 工具落地
- Claude / Codex 驱动设备操作

那这个项目应该会对你有帮助。

---

# 四、支持环境

目前支持：

| 越狱类型 | 支持系统版本 | 包架构 |
| ---------- | --------------- | ----------------- |
| `rootful` | iOS 13 - iOS 18 | `iphoneos-arm` |
| `rootless` | iOS 15 - iOS 18 | `iphoneos-arm64` |
| `roothide` | iOS 15 - iOS 18 | `iphoneos-arm64e` |

---

# 五、为什么值得关注

我觉得 iOS MCP 最有价值的地方，不是“功能多”，而是：

- **能力统一**
- **对 AI 友好**
- **真机链路完整**
- **支持越狱主流环境**

以前你可能需要拼很多工具才能完成一套真机自动化流程。
现在，AI 可以通过一套统一的 MCP 工具直接完成：

1. 获取当前页面
2. 截图和读取 UI 树
3. 判断下一步动作
4. 点击 / 输入 / 滑动
5. 安装或启动 App
6. 验证结果

这就不是“AI 给建议”，而是 **AI 真正在帮你操作手机**。

---

# 六、项目地址

GitHub：

- https://github.com/witchan/ios-mcp

# 七、效果展示
## 1、设置页截图

# 总结

iOS MCP 让 Claude、Codex、Cursor 等 AI 代理真正具备了控制 iPhone 真机的能力。它把截图、点击、输入、UI 读取、App 管理和设备控制等能力统一成一套 MCP 工具，为越狱环境下的 iPhone 自动化、测试、逆向和 AI Agent 落地提供了一种更直接的实现方式。

> 提示：阅读此文档的过程中遇到任何问题，请关住工众好【*`移动端Android和iOS开发技术分享`*】或+99 君羊【*`180680734`*】