iOS MCP — управление iPhone с джейлбрейком по MCP
iOS MCP
MCP-сервер, который ставится на iPhone с джейлбрейком и дает агенту 46 инструментов: касания, снимки экрана, OCR, приложения, файлы, логи
- 685 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Сервер без аутентификации выполняет команды оболочки, читает и пишет файлы и показывает журналы всех приложений, поэтому любой в вашей сети получает полный доступ к телефону
- Джейлбрейк снижает защиту устройства, а установка пакетов и повышение прав могут сломать систему или привести к потере данных
- Журналы и снимки экрана содержат личные данные, и вместе с запросами агента они уходят поставщику модели
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/ios-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Сервер без аутентификации выполняет команды оболочки, читает и пишет файлы и показывает журналы всех приложений, поэтому любой в вашей сети получает полный доступ к телефону
- Джейлбрейк снижает защиту устройства, а установка пакетов и повышение прав могут сломать систему или привести к потере данных
- Журналы и снимки экрана содержат личные данные, и вместе с запросами агента они уходят поставщику модели
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
iOS MCP работает прямо на телефоне как твик с MCP-сервером, и агент (Claude, Codex, Cursor) управляет устройством по сети. Касания, свайпы, долгое нажатие, перетаскивание и аппаратные кнопки идут через эмуляцию HID. Ввод текста доступен двумя способами: быстрая вставка через буфер обмена и посимвольный набор. `get_ui_elements` отдает дерево интерфейса, `tap_element` нажимает по тексту или метке, а `ocr_screen` распознает надписи офлайн через PaddleOCR с ONNX Runtime на CPU либо через Apple Vision. Дальше идет управление приложениями: запуск, остановка, список, установка и удаление `.ipa`, `.tipa` и `.deb`, чтение путей песочницы и прав приложения. Есть чтение и запись буфера обмена, просмотр каталогов, чтение и запись файлов, системный журнал всех приложений, список и чтение отчетов о падениях, яркость и громкость, данные об устройстве и открытие ссылок или схем. Инструмент `run_command` выполняет команды оболочки. Автор называет основные сценарии: автоматизация тестирования на iOS и отладка при реверс-инжиниринге. Служба слушает порт 8090, проверка здоровья отвечает JSON с версией и поддерживаемыми версиями протокола MCP. В настройках телефона копируется готовый фрагмент подсказки для агента.
Для кого. Для разработчиков, тестировщиков и исследователей iOS-приложений, у которых есть собственный iPhone с джейлбрейком и которым нужно дать Claude Code или Codex доступ к его экрану и файлам.
Подходит, если
- Нужно автоматически проходить сценарии в приложении на настоящем iPhone: касания, свайпы, ввод текста и ожидание элементов
- Агент должен читать экран устройства через дерево интерфейса и офлайн-распознавание текста с координатами
- Вы отлаживаете приложение и хотите, чтобы агент читал системный журнал и отчеты о падениях прямо с телефона
- Нужно поставить или удалить пакеты `.ipa` и `.deb` и посмотреть путь песочницы и права приложения
- Вы исследуете собственную сборку и хотите автоматизировать рутину на устройстве через MCP
Не подходит, если
- Телефон без джейлбрейка: сервер работает только на устройствах с rootful (iOS 13–18), rootless или roothide (iOS 15–18)
- Это основной телефон с личными данными и платежами: инструмент читает и пишет файлы и выполняет команды оболочки
- Нужен парк из многих устройств под единым управлением: сервер ставится на каждый телефон отдельно и слушает собственный адрес
- Нужно тестировать чужие приложения без разрешения владельца: автоматизация и реверс чужого кода могут нарушать условия сервиса и закон
Пример запроса к агенту
Открой на iPhone приложение «Настройки», найди в дереве интерфейса пункт «Wi-Fi», нажми на него и сделай снимок экрана, а потом прочитай системный журнал за последнюю минутуMCP
- Транспорт
- http
- Авторизация
- не нужна
Ограничения
Нужен iPhone с джейлбрейком. Пакеты `.deb` выпущены для трех типов: `rootful` (iOS 13–18, архитектура `iphoneos-arm`), `rootless` (iOS 15–18, `iphoneos-arm64`) и `roothide` (iOS 15–18, `iphoneos-arm64e`). Вручную нужны `mobilesubstrate` или ElleKit и `preferenceloader`, а через Cydia или Sileo ставится по имени «iOS MCP».
Во время блокировки экрана сервер отклоняет нажатия, свайпы, ввод, запуск приложений и оболочку и пропускает лишь запросы состояния, снимки экрана и пробуждение. Инструмент `mcp-root` дает ограниченное повышение прав только для бандлов, общего sudo в нем нет. Vision на iOS 13 по умолчанию распознает только английский, PaddleOCR поддерживает китайский, английский и цифры.
Автор оговаривает, что проект поставляется «как есть» и не отвечает за сбои устройства, потерю данных, проблемы с аккаунтами и другой ущерб. Сторонние компоненты вроде AppSync Unified и ldid идут под своими лицензиями.
Как отключить. Остановите службу в настройках телефона («Настройки», затем «iOS MCP»), удалите пакет через Cydia или Sileo и перезапустите SpringBoard. Из настроек агента уберите запись об этом MCP-сервере.
Частые вопросы
Как установить iOS MCP на iPhone?
Скачайте пакет `.deb` со страницы релизов, выбрав архитектуру под ваш тип джейлбрейка, либо найдите «iOS MCP» в Cydia или Sileo. После установки перезапустите SpringBoard и откройте в браузере `http://IP_УСТРОЙСТВА:8090/health`: ответ со статусом `ok` означает, что служба работает.
Как подключить сервер к Claude Code?
Запустите службу в настройках телефона и скопируйте оттуда фрагмент подсказки для агента. Адрес MCP в исходниках сервера — `/mcp` на том же порту 8090. Для Claude Code подойдет команда `claude mcp add --transport http ios-mcp http://IP_УСТРОЙСТВА:8090/mcp`.
Нужен ли джейлбрейк?
Да. Сервер работает только на устройствах с джейлбрейком типа rootful, rootless или roothide. На обычном iPhone установить его нельзя.
Безопасно ли оставлять сервер включенным?
Только в доверенной сети. У сервера нет встроенной аутентификации, а `run_command`, `read_file`, `write_file` и `get_syslog` открывают оболочку, файлы и журналы приложений, поэтому службу стоит включать на время работы.
Какие версии iOS поддерживаются?
Для rootful это iOS 13–18, для rootless и roothide iOS 15–18. Для каждого типа свой пакет: `iphoneos-arm`, `iphoneos-arm64` и `iphoneos-arm64e`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для управления iOS и Android: симуляторы, эмуляторы и реальные устройства через дерево доступности и скриншоты
MCP-сервер, который принимает команды на обычном языке и управляет iOS-симулятором через idb: приложения, нажатия, логи
MCP-сервер для iOS Simulator: тапы, свайпы, ввод текста, дерево доступности, скриншоты, видео и управление приложениями
Дает Claude Code и Codex управлять настоящим iPhone: читать экран, нажимать, вводить текст и листать в любом приложении
MCP-сервер: дает агенту облачный iPhone или Android-эмулятор с тапами, свайпами и запуском приложений.
MCP-сервер для управления Android-устройством через ADB: навигация по приложениям, ввод и авто-тесты
Коротко о README
Таблица группирует 46 инструментов по категориям: жесты, кнопки, ввод, снимки, приложения, доступность, буфер обмена, файлы, журналы, устройство, ссылки и оболочка. Раздел безопасности предупреждает о `run_command`, доступе к файлам и журналам, а в конце даны сведения о сообществе, лицензии и отказе от ответственности.