# Ios Mcp

> iOS MCP: MCP management tool for jailbroken iPhones, enabling developers and AI agents to inspect and control devices.

- **Type:** MCP server
- **Install:** `agentstack add mcp-witchan-ios-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [witchan](https://agentstack.voostack.com/s/witchan)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [witchan](https://github.com/witchan)
- **Source:** https://github.com/witchan/ios-mcp

## Install

```sh
agentstack add mcp-witchan-ios-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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 设备自动化与逆向调试的主要场景。

## 运行要求

- 越狱 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.1","protocolVersion":"2025-11-25","supportedProtocolVersions":["2025-11-25","2025-06-18","2025-03-26"]}
```

## 使用

安装后打开设备「设置」→「iOS MCP」，启动服务后点击「复制 MCP 提示词片段」，将其粘贴到你的 AI 提示词中即可。

  

下载设备上的大文件或二进制文件时，可直接访问 HTTP 端点，避免 base64 截断：

```bash
curl 'http://设备IP:8090/download_file?path=/var/mobile/...' -o output.bin
```

## 安全说明

- 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 `、`dpkg -s|-r|--remove|--purge `；它不是通用 sudo

## 社区交流

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

| 微信交流群（6群开放中） | 公众号 |
|---|---|
| 1群：已满2群：已满3群：已满4群：已满5群：已满6群：已满7群：开放中 | `移动端Android和iOS开发技术分享` |
|  |  |

> 7群二维码如已过期，请添加微信 `witchan028` 或关注公众号 `移动端Android和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)。

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [witchan](https://github.com/witchan)
- **Source:** [witchan/ios-mcp](https://github.com/witchan/ios-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-witchan-ios-mcp
- Seller: https://agentstack.voostack.com/s/witchan
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.