Back to search
ios-mcp
MCP serverGitHub
iOS MCP: MCP management tool for jailbroken iPhones, enabling developers and AI agents to inspect and control devices.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/witchan--ios-mcp)HTML
<a href="/listings/witchan--ios-mcp"><img src="/api/listings/witchan--ios-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 134 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # iOS MCP
- 中文 | [English](README_EN.md)
- iOS MCP 是一个运行在越狱 iPhone 上的 [MCP (Model Context Protocol)](https://modelcontextprotocol.io) 服务器,让 AI 代理(Claude、Codex、Cursor 等)能够直接操控 iOS 设备。
- ## 功能概览
- | 类别 | 工具 | 说明 |
- |------|------|------|
- | **触控手势** | `tap_screen` `swipe_screen` `long_press` `double_tap` `drag_and_drop` | 精确屏幕坐标操作,支持路径拖动 |
- | **硬件按键** | `press_home` `press_power` `press_volume_up` `press_volume_down` `toggle_mute` `wake_and_home` | HID 模拟物理按键,锁屏/熄屏唤醒 |
- | **文字输入** | `input_text` `type_text` `press_key` | 剪贴板快速输入 / HID 逐字模拟 / 特殊键 |
- | **截图** | `screenshot` `get_screen_info` | Base64 JPEG 截图、屏幕尺寸与方向 |
- | **App 管理** | `launch_app` `kill_app` `list_apps` `list_running_apps` `get_frontmost_app` `get_app_info` `install_app` `uninstall_app` | 启动/关闭 App,安装/卸载 App 或 DEB,查询 App 沙盒/容器路径与 entitlements |
- | **无障碍 / 元素操作** | `get_ui_elements` `get_element_at_point` `tap_element` `wait_for_element` `wait_for_disappear` `ocr_screen` `describe_screen` | 获取 UI 节点树、坐标元素查询,按文本/标签点击元素、等待元素出现或消失,屏幕 OCR 文字识别与定位、聚合屏幕快照 |
- | **剪贴板** | `get_clipboard` `set_clipboard` | 读写剪贴板内容 |
- | **文件系统** | `list_dir` `read_file` `write_file` | 目录列举、文件读写(支持文本与二进制) |
- | **日志** | `get_syslog` `get_crash_logs` `read_crash_log` | 全 App 实时系统日志、崩溃日志列举与读取 |
- | **设备控制** | `get_brightness` `set_brightness` `get_volume` `set_volume` | 亮度、音量 |
- | **设备信息** | `get_device_info` | 型号、iOS 版本、电池、存储、内存、越狱方式 |
- | **URL** | `open_url` | 打开链接或 URL Scheme |
- | **Shell** | `run_command` | 执行 Shell 命令 |
- 共 **46** 个 MCP 工具,覆盖 iOS 设备自动化与逆向调试的主要场景。
- `install_app` 支持 `.ipa`、`.tipa` 和 `.deb`(扩展名不区分大小写)。`.tipa` 按 IPA 安装;
- 电脑上的文件需先通过 `POST /upload_file` 上传,再将返回的设备路径传给 `install_app`。
- `ocr_screen` 与 `describe_screen(include_ocr=true)` 支持可选的 `engine` 参数:
- 省略或传 `"paddleocr"` 使用离线 PaddleOCR + ONNX Runtime CPU;传 `"vision"` 使用 Apple Vision。
- 选择仅影响当前请求,失败不会自动换引擎。Vision 在 iOS 13 默认识别英文;PaddleOCR 支持中英文与数字。
- 构建依赖、参数示例和验证说明见 [OCR 引擎文档](docs/PADDLEOCR.md)。
- ## 运行要求
- - 越狱 iOS 设备
- ## 安装说明
- ### 支持环境
- | 越狱类型 | 支持系统版本 | 包架构 |
- |------|------|------|
- | `rootful` | iOS 13 - iOS 18 | `iphoneos-arm` |
- | `rootless` | iOS 15 - iOS 18 | `iphoneos-arm64` |
- | `roothide` | iOS 15 - iOS 18 | `iphoneos-arm64e` |
- ### 安装方式
- #### 方式一:从 Release 页面下载安装包
- 请根据越狱类型选择上表对应架构的 deb 包。
- 手动安装时请注意以下依赖:
- - `mobilesubstrate/ElleKit`
- - `preferenceloader`
- #### 方式二:通过 Cydia / Sileo 直接安装
- 可在以下包管理器中直接搜索并安装:
- - `Cydia`
- - `Sileo`
- 搜索名称:
- - `iOS MCP`
- ### 安装完成后建议执行以下检查
- 1. 重启一次 `SpringBoard`
- 2. 浏览器访问:
- ```text
- http://设备IP:8090/health
- ```
- 3. 返回以下内容表示服务启动正常:
- ```json
- {"status":"ok","server":"ios-mcp","version":"1.2.8","protocolVersion":"2025-11-25","supportedProtocolVersions":["2025-11-25","2025-06-18","2025-03-26"]}
- ```
- ## 使用
- 安装后打开设备「设置」→「iOS MCP」,启动服务后点击「复制并分享 MCP 提示词片段」,将其粘贴到你的 AI 提示词中即可。
- 设置页跟随设备语言显示简体中文、繁体中文或英文,无需手动选择语言。
- <p align="center">
- <img src="screenshots/settings.jpeg" alt="iOS MCP 设置" width="300">
- </p>
- ## 安全说明
- - MCP 服务无内置认证,建议仅在局域网环境下使用
- - MCP 协议默认支持 `2025-11-25`,并兼容 `2025-06-18`、`2025-03-26`;HTTP 响应会返回 `MCP-Protocol-Version`
- - 锁屏或熄屏时,服务端会拦截点击、滑动、输入、启动 App、Shell 等交互/写入类工具,只放行状态查询、截图和唤醒恢复类工具
- - `run_command` 工具可执行任意 Shell 命令,请谨慎使用
- - `read_file` / `write_file` / `download_file` 可读写 MCP 服务进程权限范围内的设备路径,与 `run_command` 风险等级一致,请仅在可信网络使用
- - `get_syslog` 通过 `mcp-logreader`(签 `com.apple.private.logging.stream` entitlement)读取全 App 实时日志,可能包含敏感信息,请仅在可信网络使用
- - `mcp-root` 提供受限 root 提权能力,仅允许包内工具、受限 chmod/launchctl、无参数 id,以及受限 `dpkg -i|--install|--unpack <绝对路径.deb>`、`dpkg -s|-r|--remove|--purge <package-id>`;它不是通用 sudo
- ## 社区交流
- `iOS MCP` 已经聚集了不少开发者和用户持续交流,目前已建立多个微信交流群。
- | 微信交流群(8群开放中) | 公众号 |
- |---|---|
- | 1群:已满<br>2群:已满<br>3群:已满<br>4群:已满<br>5群:已满<br>6群:已满<br>7群:已满<br>8群:开放中 | `小陈iOS逆向与安全` |
- | <img src="https://raw.githubusercontent.com/witchan/Imgur/main/group6_qr.JPG" alt="iOS MCP 微信 8 群二维码" width="260"> | <img src="prefs/Resources/wechat_qr.jpg" alt="移动端Android和iOS开发技术分享 公众号二维码" width="220"> |
- > 8群二维码如已过期,请添加微信 `witchan028` 或关注公众号 `小陈iOS逆向与安全` 获取最新入群方式。
- 欢迎添加微信或关注公众号,获取最新动态与入群方式。
- - 微信:`witchan028`
- - 邮箱:`witchan028@126.com`
- ## 作者
- **witchan**
- ## 许可
- 本项目自有代码使用 MIT License,详见 [LICENSE](LICENSE)。
- 使用、修改、分发或合并本项目自有源码及其重要部分时,应保留版权声明和许可证文本。[NOTICE](NOTICE) 提供项目出处和免责说明。
- 本项目按 “AS IS” 方式提供,不提供任何明示或暗示担保。因使用、修改、分发、部署或运行本项目导致的设备异常、数据丢失、服务中断、账号风险、系统损坏、安全问题、商业损失或其他直接/间接影响,作者不承担责任。
- 项目中包含的第三方组件(如 AppSync Unified、appinst、ldid、OpenSSL、libplist、libzip)遵循各自的开源协议,详见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.