Ios MCP

iOS MCP

中文 | English

iOS MCP 是一个运行在越狱 iPhone 上的 MCP (Model Context Protocol) 服务器，让 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 引擎文档。

运行要求

• 越狱 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. 浏览器访问：

http://设备IP:8090/health

3. 返回以下内容表示服务启动正常：

{"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。

使用、修改、分发或合并本项目自有源码及其重要部分时，应保留版权声明和许可证文本。NOTICE 提供项目出处和免责说明。

本项目按 “AS IS” 方式提供，不提供任何明示或暗示担保。因使用、修改、分发、部署或运行本项目导致的设备异常、数据丢失、服务中断、账号风险、系统损坏、安全问题、商业损失或其他直接/间接影响，作者不承担责任。

项目中包含的第三方组件（如 AppSync Unified、appinst、ldid、OpenSSL、libplist、libzip）遵循各自的开源协议，详见 THIRD_PARTY_NOTICES.md。