iPhone Mirror — MCP-сервер для Claude Code: управление iPhone
MCP-сервер, который через iPhone Mirroring на macOS даёт модели управлять реальным iPhone и прогонять сборку и тесты Xcode на симуляторах и устройствах.
Открыть на GitHubЧто делает iPhone Mirror
Сервер подключается к встроенному в macOS приложению iPhone Mirroring и превращает зеркальный экран в рабочую поверхность для модели: скриншоты, OCR, тапы, свайпы, ввод текста. Ничего ставить на телефон не нужно, джейлбрейк тоже не требуется.
Внутри 63 инструмента. Часть отвечает за Xcode: сборка, тесты, установка и запуск на симуляторах и подключённых устройствах. Остальные работают с экраном — screenshot, read_screen, tap, paste_text, wait_for_text — и позволяют проверить, что именно видит пользователь. Есть отдельный doctor, который проверяет права доступа и подтверждает, что macOS действительно передаёт синтетический ввод.
Нужны macOS 15+ и iPhone на iOS 18+, сопряжённый по Bluetooth и той же учётной записи Apple. Разрешения Accessibility и Screen Recording выдаются приложению, которое запускает сервер, — терминалу или десктопному клиенту. Без них ничего не заработает. Жест «щипок» и поворот синтезировать нельзя, а сессия встаёт на паузу, как только телефон берут в руки или разблокируют.
Какие задачи решает
- прогнать сборку и тесты на реальном iPhone из чата
- проверить, что приложение показывает нужный текст после запуска
- нажать кнопку на экране телефона без ручного ввода
- снять скриншот и распознать текст на нём
- дождаться появления надписи вместо фиксированной паузы
Примеры запросов агенту
- Сделай скриншот iPhone и скажи, какое приложение открыто
- Собери проект и запусти его на подключённом iPhone через
run_on_iphone - Найди на экране текст «Продолжить» и нажми по нему
Как установить iPhone Mirror
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о iPhone Mirror
Как установить iPhone Mirror в Claude Code?
Сначала склонируйте репозиторий, перейдите в папку и запустите ./install.sh — скрипт соберёт бинарник и проверит права. Затем добавьте сервер командой claude mcp add --scope user iphone-mirror -- ~/.local/bin/iphone-mirror-mcp.
Что делает iPhone Mirror?
Управляет физическим iPhone через iPhone Mirroring на macOS: делает скриншоты, распознаёт текст, нажимает и свайпает, вводит текст. Плюс автоматизирует сборку и тесты Xcode на симуляторах и устройствах.
Какие разрешения нужны серверу?
Accessibility и Screen Recording, выданные приложению, которое запускает сервер. Проверить всё сразу можно командой iphone-mirror-mcp doctor.
