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 提示词中即可。

设置页跟随设备语言显示简体中文、繁体中文或英文，无需手动选择语言。

安全说明

• 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 ；它不是通用 sudo

社区交流

iOS MCP 已经聚集了不少开发者和用户持续交流，目前已建立多个微信交流群。