Позволяет AI-агентам, например Claude Code или Codex, считывать экран, нажимать, вводить текст и свайпать на реальном iPhone через USB или Wi-Fi с помощью MCP.
jfarcand/mirroir-mcp
MCP-сервер, с которым любой AI-агент может управлять обычным iPhone через iPhone Mirroring в macOS — без Developer Mode, Xcode и WebDriverAgent.
- Звёзды
- 281
- Форки
- 38
- Открытые issues
- 3
- Последний коммит
- 21 час назад
Что это?
mirroir-mcp — MCP-сервер для macOS, который управляет настоящим iPhone без модификаций через функцию iPhone Mirroring от Apple. AI-клиент может считывать содержимое экрана с помощью OCR или компьютерного зрения, а затем нажимать, проводить пальцем, вводить текст и нажимать системные клавиши. Поскольку сервер работает с экраном самого телефона, через него можно использовать приложения из App Store, которые пользователь не смог бы самостоятельно собрать или инструментировать.
Помимо базового цикла управления, сервер предоставляет набор инструментов высокого уровня для навигации, прокрутки и управления жизненным циклом приложений. Агент может исследовать приложение в ширину и создавать сценарии SKILL.md. Навыки можно скомпилировать и воспроизводить без LLM с помощью CLI-команды `mirroir test`; она формирует отчёт JUnit и отдельный вердикт о расхождениях для использования в CI.
В проект также входит `mirroir-run` — раннер на Rust, который объединяет шаги для iPhone с шагами для веба (Playwright), HTTP и подпроцессов в одном сценарии. Для iOS-части нужен Mac с подключённым iPhone Mirroring; остальные сценарии можно запускать на Linux.
Ключевые возможности
- 01Управляет обычным iPhone через iPhone Mirroring: нажимает, проводит пальцем, вводит текст и отправляет нажатия клавиш.
- 02Считывает экран с помощью Apple Vision OCR, опционального распознавания значков через YOLO или режима AI vision.
- 03Работает с любым MCP-клиентом и предоставляет 38 инструментов.
- 04Исследует приложения и создаёт воспроизводимые навыки SKILL.md.
- 05Воспроизводит скомпилированные навыки из CLI без LLM и формирует отчёты JUnit.
- 06По умолчанию действует по принципу fail-closed; поддерживает настройки разрешений и списки заблокированных приложений.
Сценарии использования
- Запуск сквозных smoke-тестов для приложений из App Store, которые нельзя инструментировать.
- Поручение AI-ассистенту повседневных задач на телефоне, например отправки сообщений или создания событий в календаре.
- Запись пошагового ручного сценария и его воспроизведение в CI.
- Объединение проверок iPhone и веб-страниц в один кроссплатформенный тест.
Быстрый старт
- 1
Установите сервер через npx (требуются macOS 15 или новее и «Повтор iPhone»)
npx -y mirroir-mcp install - 2
При первом снимке экрана macOS запросит разрешения — предоставьте доступ к записи экрана и универсальному доступу
- 3
Зарегистрируйте mirroir в Claude Code как MCP-сервер
claude mcp add --transport stdio mirroir -- npx -y mirroir-mcp
Что важно знать
- Работает только в macOS 15 или новее с функцией «Повтор iPhone»; Android и iOS Simulator не поддерживаются.
- Игры, требующие быстрой реакции или мультитач-управления, недоступны, поскольку «Повтор iPhone» поддерживает только один указатель.
В подборках
Темы
Частые вопросы
- Что такое mirroir-mcp?
- MCP-сервер, с которым любой AI-агент может управлять обычным iPhone через iPhone Mirroring в macOS — без Developer Mode, Xcode и WebDriverAgent. mirroir-mcp — MCP-сервер для macOS, который управляет настоящим iPhone без модификаций через функцию iPhone Mirroring от Apple. AI-клиент может считывать содержимое экрана с помощью OCR или компьютерного зрения, а затем нажимать, проводить пальцем, вводить текст и нажимать системные клавиши. Поскольку сервер работает с экраном самого телефона, через него можно использовать приложения из App Store, которые пользователь не смог бы самостоятельно собрать или инструментировать.
- mirroir-mcp можно использовать бесплатно? Какая у него лицензия?
- mirroir-mcp распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
- mirroir-mcp всё ещё поддерживается?
- Активно поддерживается. Последний коммит в mirroir-mcp — 6 нояб. 2026 г..
- Для чего можно использовать mirroir-mcp?
- Запуск сквозных smoke-тестов для приложений из App Store, которые нельзя инструментировать. Поручение AI-ассистенту повседневных задач на телефоне, например отправки сообщений или создания событий в календаре. Запись пошагового ручного сценария и его воспроизведение в CI. Объединение проверок iPhone и веб-страниц в один кроссплатформенный тест.
- Как установить mirroir-mcp?
- Установите сервер через npx (требуются macOS 15 или новее и «Повтор iPhone»): npx -y mirroir-mcp install При первом снимке экрана macOS запросит разрешения — предоставьте доступ к записи экрана и универсальному доступу Зарегистрируйте mirroir в Claude Code как MCP-сервер: claude mcp add --transport stdio mirroir -- npx -y mirroir-mcp
- Где скачать mirroir-mcp?
- Исходный код и инструкции по установке — на GitHub: https://github.com/jfarcand/mirroir-mcp
Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.
Похожие проекты
Open-source сервис Computer Use в виде MCP-сервера, который позволяет AI-агентам управлять рабочим столом macOS, Linux и Windows.
Автоматизация Android на естественном языке для AI-помощников по программированию и тестовых наборов на реальных устройствах и эмуляторах.
Опенсорсный AI-агент для тестирования, который превращает Gherkin feature-файлы в автоматизированные сквозные тесты браузера, API, безопасности, доступности и визуального интерфейса.
Виртуальная машина macOS, которой AI-агенты управляют через MCP-инструменты, а её экран отображается в терминале с помощью графики Kitty, Ghostty или iTerm2.
Открывает любой агентской среде доступ к runtime управления компьютером Codex на macOS и Linux без аутентификации Codex.