mirroir-mcp — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер mirroir-mcp для Claude Code управляет реальным iPhone через macOS iPhone Mirroring: читает экран, нажимает, свайпит и вводит текст. Тестирует мобильные приложения.
Apache-2.0 ★ 400 обновлён 2026-10-23
claude mcp add mirroir-mcp -- npx -y mirroir-mcpЧто делает mirroir-mcp
Сервер подключает агента к реальному iPhone через macOS iPhone Mirroring. Работа идёт циклом: describe_screen отдаёт текст на экране с координатами для нажатия, модель решает, что делать дальше, а tap, type_text или swipe выполняют шаг. Затем агент смотрит на экран снова.
В сервере 38 инструментов. Среди них press_back, press_home, spotlight, scroll_to (листает, пока не появится нужный текст), reset_app (полностью закрывает приложение через переключатель) и set_network. Если написать файл APP.md с описанием приложения, сервер прочитает его перед исследованием: из него берутся тип экрана, всплывающие окна для автозакрытия и элементы, которые надо обходить.
Нужны macOS 15+ и iPhone, подключённый через iPhone Mirroring. При первом скриншоте macOS запросит разрешения Screen Recording и Accessibility, выдать надо оба. Игры в реальном времени не получатся: у iPhone Mirroring один указатель, и управление двумя стиками недоступно. Меню, магазин и экраны победы ведутся как обычный интерфейс приложения.
Какие задачи решает
- прогнать сценарий входа в iOS-приложении на реальном iPhone и снять скриншот после каждого шага
- поручить агенту написать в Messages или завести событие в Calendar
- пройти меню и магазин игры как быстрый смоук-тест
- пролистать длинный экран до нужного текста
- записать пройденные шаги, чтобы потом воспроизвести их повторно
Примеры запросов агенту
- Через mirroir открой на iPhone мой Expo Go, зайди в LoginDemo и проверь экран входа с неверным паролем. Скриншот после каждого шага.
- Вызови
describe_screenи скажи, что сейчас на экране iPhone. - Пролистай настройки iPhone до пункта «Основные» и открой его.
Как установить mirroir-mcp
Командой платформы
claude mcp add mirroir-mcp -- npx -y mirroir-mcpКомандой платформы
codex mcp add mirroir-mcp -- npx -y mirroir-mcpФайл настроек
{
"mcpServers": {
"mirroir-mcp": {
"command": "npx",
"args": [
"-y",
"mirroir-mcp"
]
}
}
}Файл настроек
{
"servers": {
"mirroir-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mirroir-mcp"
]
}
}
}Командой платформы
gemini mcp add mirroir-mcp npx -y mirroir-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mirroir-mcp
Как установить mirroir-mcp в Claude Code?
Выполните claude mcp add mirroir-mcp -- npx -y mirroir-mcp. При первом скриншоте macOS попросит доступ к записи экрана и универсальный доступ.
Что делает mirroir-mcp?
Позволяет ИИ-агенту управлять реальным iPhone через macOS iPhone Mirroring. Агент видит текст на экране вместе с координатами, нажимает, свайпит, вводит текст и листает до нужного элемента.
Что нужно для работы mirroir-mcp?
macOS 15+ и iPhone, подключённый через iPhone Mirroring. Ещё нужно выдать разрешения Screen Recording и Accessibility, которые macOS запросит при первом скриншоте.