Skip to content
Back to search

ios-mcp

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/witchan--ios-mcp/badge.svg)](/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)

  1. # iOS MCP
  2. 中文 | [English](README_EN.md)
  3. iOS MCP 是一个运行在越狱 iPhone 上的 [MCP (Model Context Protocol)](https://modelcontextprotocol.io) 服务器,让 AI 代理(Claude、Codex、Cursor 等)能够直接操控 iOS 设备。
  4. ## 功能概览
  5. | 类别 | 工具 | 说明 |
  6. |------|------|------|
  7. | **触控手势** | `tap_screen` `swipe_screen` `long_press` `double_tap` `drag_and_drop` | 精确屏幕坐标操作,支持路径拖动 |
  8. | **硬件按键** | `press_home` `press_power` `press_volume_up` `press_volume_down` `toggle_mute` `wake_and_home` | HID 模拟物理按键,锁屏/熄屏唤醒 |
  9. | **文字输入** | `input_text` `type_text` `press_key` | 剪贴板快速输入 / HID 逐字模拟 / 特殊键 |
  10. | **截图** | `screenshot` `get_screen_info` | Base64 JPEG 截图、屏幕尺寸与方向 |
  11. | **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 |
  12. | **无障碍 / 元素操作** | `get_ui_elements` `get_element_at_point` `tap_element` `wait_for_element` `wait_for_disappear` `ocr_screen` `describe_screen` | 获取 UI 节点树、坐标元素查询,按文本/标签点击元素、等待元素出现或消失,屏幕 OCR 文字识别与定位、聚合屏幕快照 |
  13. | **剪贴板** | `get_clipboard` `set_clipboard` | 读写剪贴板内容 |
  14. | **文件系统** | `list_dir` `read_file` `write_file` | 目录列举、文件读写(支持文本与二进制) |
  15. | **日志** | `get_syslog` `get_crash_logs` `read_crash_log` | 全 App 实时系统日志、崩溃日志列举与读取 |
  16. | **设备控制** | `get_brightness` `set_brightness` `get_volume` `set_volume` | 亮度、音量 |
  17. | **设备信息** | `get_device_info` | 型号、iOS 版本、电池、存储、内存、越狱方式 |
  18. | **URL** | `open_url` | 打开链接或 URL Scheme |
  19. | **Shell** | `run_command` | 执行 Shell 命令 |
  20. 共 **46** 个 MCP 工具,覆盖 iOS 设备自动化与逆向调试的主要场景。
  21. `install_app` 支持 `.ipa`、`.tipa` 和 `.deb`(扩展名不区分大小写)。`.tipa` 按 IPA 安装;
  22. 电脑上的文件需先通过 `POST /upload_file` 上传,再将返回的设备路径传给 `install_app`。
  23. `ocr_screen` 与 `describe_screen(include_ocr=true)` 支持可选的 `engine` 参数:
  24. 省略或传 `"paddleocr"` 使用离线 PaddleOCR + ONNX Runtime CPU;传 `"vision"` 使用 Apple Vision。
  25. 选择仅影响当前请求,失败不会自动换引擎。Vision 在 iOS 13 默认识别英文;PaddleOCR 支持中英文与数字。
  26. 构建依赖、参数示例和验证说明见 [OCR 引擎文档](docs/PADDLEOCR.md)。
  27. ## 运行要求
  28. - 越狱 iOS 设备
  29. ## 安装说明
  30. ### 支持环境
  31. | 越狱类型 | 支持系统版本 | 包架构 |
  32. |------|------|------|
  33. | `rootful` | iOS 13 - iOS 18 | `iphoneos-arm` |
  34. | `rootless` | iOS 15 - iOS 18 | `iphoneos-arm64` |
  35. | `roothide` | iOS 15 - iOS 18 | `iphoneos-arm64e` |
  36. ### 安装方式
  37. #### 方式一:从 Release 页面下载安装包
  38. 请根据越狱类型选择上表对应架构的 deb 包。
  39. 手动安装时请注意以下依赖:
  40. - `mobilesubstrate/ElleKit`
  41. - `preferenceloader`
  42. #### 方式二:通过 Cydia / Sileo 直接安装
  43. 可在以下包管理器中直接搜索并安装:
  44. - `Cydia`
  45. - `Sileo`
  46. 搜索名称:
  47. - `iOS MCP`
  48. ### 安装完成后建议执行以下检查
  49. 1. 重启一次 `SpringBoard`
  50. 2. 浏览器访问:
  51. ```text
  52. http://设备IP:8090/health
  53. ```
  54. 3. 返回以下内容表示服务启动正常:
  55. ```json
  56. {"status":"ok","server":"ios-mcp","version":"1.2.8","protocolVersion":"2025-11-25","supportedProtocolVersions":["2025-11-25","2025-06-18","2025-03-26"]}
  57. ```
  58. ## 使用
  59. 安装后打开设备「设置」→「iOS MCP」,启动服务后点击「复制并分享 MCP 提示词片段」,将其粘贴到你的 AI 提示词中即可。
  60. 设置页跟随设备语言显示简体中文、繁体中文或英文,无需手动选择语言。
  61. <p align="center">
  62. <img src="screenshots/settings.jpeg" alt="iOS MCP 设置" width="300">
  63. </p>
  64. ## 安全说明
  65. - MCP 服务无内置认证,建议仅在局域网环境下使用
  66. - MCP 协议默认支持 `2025-11-25`,并兼容 `2025-06-18`、`2025-03-26`;HTTP 响应会返回 `MCP-Protocol-Version`
  67. - 锁屏或熄屏时,服务端会拦截点击、滑动、输入、启动 App、Shell 等交互/写入类工具,只放行状态查询、截图和唤醒恢复类工具
  68. - `run_command` 工具可执行任意 Shell 命令,请谨慎使用
  69. - `read_file` / `write_file` / `download_file` 可读写 MCP 服务进程权限范围内的设备路径,与 `run_command` 风险等级一致,请仅在可信网络使用
  70. - `get_syslog` 通过 `mcp-logreader`(签 `com.apple.private.logging.stream` entitlement)读取全 App 实时日志,可能包含敏感信息,请仅在可信网络使用
  71. - `mcp-root` 提供受限 root 提权能力,仅允许包内工具、受限 chmod/launchctl、无参数 id,以及受限 `dpkg -i|--install|--unpack <绝对路径.deb>`、`dpkg -s|-r|--remove|--purge <package-id>`;它不是通用 sudo
  72. ## 社区交流
  73. `iOS MCP` 已经聚集了不少开发者和用户持续交流,目前已建立多个微信交流群。
  74. | 微信交流群(8群开放中) | 公众号 |
  75. |---|---|
  76. | 1群:已满<br>2群:已满<br>3群:已满<br>4群:已满<br>5群:已满<br>6群:已满<br>7群:已满<br>8群:开放中 | `小陈iOS逆向与安全` |
  77. | <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"> |
  78. > 8群二维码如已过期,请添加微信 `witchan028` 或关注公众号 `小陈iOS逆向与安全` 获取最新入群方式。
  79. 欢迎添加微信或关注公众号,获取最新动态与入群方式。
  80. - 微信:`witchan028`
  81. - 邮箱:`witchan028@126.com`
  82. ## 作者
  83. **witchan**
  84. ## 许可
  85. 本项目自有代码使用 MIT License,详见 [LICENSE](LICENSE)。
  86. 使用、修改、分发或合并本项目自有源码及其重要部分时,应保留版权声明和许可证文本。[NOTICE](NOTICE) 提供项目出处和免责说明。
  87. 本项目按 “AS IS” 方式提供,不提供任何明示或暗示担保。因使用、修改、分发、部署或运行本项目导致的设备异常、数据丢失、服务中断、账号风险、系统损坏、安全问题、商业损失或其他直接/间接影响,作者不承担责任。
  88. 项目中包含的第三方组件(如 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 in

Free to use. If it’s helped, pass it on.