iphone-use MCP
Дает Claude Code и Codex управлять настоящим iPhone: читать экран, нажимать, вводить текст и листать в любом приложении
- 399 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент нажимает и вводит текст в любом приложении телефона, включая банковские и мессенджеры
- Через экран агент читает личные данные, например сообщения и записи Здоровья
- Исходники под лицензией PolyForm Shield: коммерческое использование ограничено условиями автора
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/leeguooooo/iphone-use/main/install.sh | shЗапускают на Mac с подключенным и разблокированным iPhone. Скрипт настраивает телефон и регистрирует MCP-сервер.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент нажимает и вводит текст в любом приложении телефона, включая банковские и мессенджеры
- Через экран агент читает личные данные, например сообщения и записи Здоровья
- Исходники под лицензией PolyForm Shield: коммерческое использование ограничено условиями автора
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
iphone-use управляет физическим iPhone с Mac. На Mac работает служебная программа, на телефон ставится небольшой XCTest-раннер. Программа читает экран как дерево доступности, то есть текстом без снимка экрана, и отправляет на телефон нажатия, ввод и жесты. Перед ответом она ждет, пока экран перестанет меняться. Агент получает инструменты с префиксом phone_. Они открывают приложение по имени, читают элементы экрана и выполняют пачку шагов за один вызов. Вводить можно до 20 тысяч символов за раз. Каждое действие возвращает статус (применено, не отправлено или неизвестно) и сообщает, можно ли безопасно повторить. Нажатие на перекрытый элемент отклоняется. Повторяющуюся задачу можно записать как flow: сценарий для конкретного приложения, который потом запускается одним вызовом без модели и без расхода токенов. Для людей есть веб-страница, где экран телефона транслируется в реальном времени, и приложение для управления с другого iPhone. Управлять можно по USB и по Wi-Fi. Разработчикам приложений те же инструменты отдают логи и отчеты о сбоях и пишут видео экрана. Еще они ставят сборки .ipa и подменяют геопозицию.
Для кого. Для разработчиков и тестировщиков iOS-приложений и для тех, кто хочет автоматизировать приложения на iPhone без API с помощью Claude Code, Codex или Cursor.
Подходит, если
- Нужно прогнать сценарий входа в свое приложение на настоящем телефоне и узнать, на каком шаге он ломается
- Нужно выгрузить данные из приложения без API, например шаги за неделю из Здоровья или список операций на странице выписки
- Нужны тестовые наборы для iOS-приложения с кодом выхода, который понимает CI
- Нужно следить за агентом по трансляции экрана телефона и в любой момент взять управление в браузере
- Нужен тест на старом iPhone с iOS 15, который нельзя обновить
Не подходит, если
- Нет Mac: сервер работает только на macOS
- Нужен Android: проект управляет только iPhone
- Задача укладывается в API приложения: прямой вызов API проще и дешевле нажатий по экрану
Пример запроса к агенту
Открой Здоровье на iPhone и скажи, сколько шагов я проходил каждый день на этой неделе.MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
IPHONE_USE_BLOCKED_APPS- Список приложений, которые демон откажется открывать, например Wallet и Passwords
IPHONE_USE_MAX_ACTIONS- Предел числа действий за одну задачу
IPHONE_USE_MCP_TOKENсекрет- Токен для режима MCP по HTTP на адресе не из локальной сети, без него такой режим не запускается
Ограничения
Лицензия PolyForm Shield 1.0.0: код открыт для чтения и изменения, но для конкурирующего продукта или сервиса его использовать нельзя, даже для бесплатного.
Первую настройку делают вручную, по кабелю и с разблокированным телефоном. На iOS 15 и 16 связь по локальной сети идет без шифрования. Банковские приложения закрывают экран от записи, и тогда агенту доступен только каркас элементов.
Пароли, коды и Face ID агент не вводит: он останавливается и просит завершить вход на телефоне. Для раннера хватает бесплатного Apple ID, а приложению для управления с другого iPhone без Mac нужен платный аккаунт разработчика.
Как отключить. Команда `~/.iphone-use/uninstall.sh --dry-run` показывает, что будет удалено, а запуск без `--dry-run` удаляет установку. Плагины убираются обычными командами Claude Code и Codex. Чтобы агент не видел часть инструментов, задайте `IPHONE_USE_MCP_TOOLS=readonly`, тогда остаются только инструменты чтения.
Частые вопросы
Как поставить iphone-use в Claude Code?
Сначала выполните установочный скрипт на Mac с подключенным iPhone: он настроит телефон и зарегистрирует MCP-сервер в Claude Code, Codex, а если они стоят, то и в Cursor и Claude Desktop. Отдельно можно добавить плагин командами `/plugin marketplace add leeguooooo/iphone-use` и `/plugin install iphone-use@iphone-use`. Он добавляет скилл и сервер, но установочный скрипт все равно нужен.
Что такое flow в iphone-use?
Это проверенный сценарий для одного приложения. Агент выполняет задачу один раз, а демон записывает шаги как черновик, и потом сценарий запускается одним вызовом без модели, например командой `flow run health/export-all-zh-cn`. Готовые сценарии берутся из реестра iphone-use-flows.
Можно ли запретить агенту открывать некоторые приложения?
Да. Переменная IPHONE_USE_BLOCKED_APPS задает список закрытых приложений, например Wallet и Passwords, а IPHONE_USE_MAX_ACTIONS ограничивает число действий за задачу. Демон применяет эти пределы независимо от подсказок агента.
Отправляет ли iphone-use данные на сторону?
Сборка не шлет статистику использования. Демон слушает 127.0.0.1:44321 под паролем, а раннер на телефоне принимает только запросы с подписанным токеном запуска. Вводимый текст в журнал не пишется, сохраняется только его длина.
Что нужно для первой настройки iphone-use?
Mac с macOS 15 или новее, Xcode с входом в Apple ID (подойдет бесплатный), iPhone с iOS 15 или новее и включенным режимом разработчика, кабель USB. Телефон нужно разблокировать перед установкой. Если чего-то не хватает, команда `iphone-use doctor` назовет недостающее и подскажет, как исправить.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для управления iOS и Android: симуляторы, эмуляторы и реальные устройства через дерево доступности и скриншоты
Команда npx serve-sim выводит симулятор iOS в браузер и позволяет агенту нажимать, свайпать, вводить текст и подменять камеру
MCP-сервер для iOS Simulator: тапы, свайпы, ввод текста, дерево доступности, скриншоты, видео и управление приложениями
Плагин DeepSeek Harness: iOS Simulator и iPhone по USB прямо в диалоге, 22 инструмента управления
Скиллы и CLI, чтобы Claude Code, Codex и OpenCode управляли Android-телефоном: открывали приложения, нажимали, вводили текст и тестировали сценарии
MCP-сервер управляет реальным iPhone через macOS iPhone Mirroring: агент видит экран, нажимает, листает и вводит текст
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| iphone-use (эта запись) | нет | не нужна | 399 | |
| Mobile MCP | нет | не нужна | 10 095 | управляет iOS и Android через общий MCP-сервер, а iphone-use ограничен iPhone и дает запись сценариев для повтора без модели |
| agent-device | нет | 5 183 | тоже дает агенту мобильное устройство, а iphone-use читает экран заметно быстрее по замерам автора |
Коротко о README
В документации есть замеры скорости на iPhone 13 по USB: чтение экрана занимает 0,08–0,135 с, у agent-device около 0,7 с. Там же описаны удаленное управление из браузера, HTTP API для скриптов и запуск тестовых наборов по расписанию.