# mirroir-mcp

MCP-сервер mirroir-mcp для Claude Code управляет реальным iPhone через macOS iPhone Mirroring: читает экран, нажимает, свайпит и вводит текст. Тестирует мобильные приложения.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 400 у репозитория
- Автор: jfarcand
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/jfarcand/mirroir-mcp
- Обновлён: 2026-10-23
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — внимание: команда скачивает скрипт с mirroir.dev и сразу его запускает. Без явного «да» человека такие команды не запускай.
- HTML: https://affpapa.org/nevibecode/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 один указатель, и управление двумя стиками недоступно. Меню, магазин и экраны победы ведутся как обычный интерфейс приложения.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add mirroir-mcp -- npx -y mirroir-mcp
```

### Codex

**Командой платформы**
```bash
codex mcp add mirroir-mcp -- npx -y mirroir-mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mirroir-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "mirroir-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mirroir-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mirroir-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add mirroir-mcp npx -y mirroir-mcp
```

## Когда брать
- прогнать сценарий входа в iOS-приложении на реальном iPhone и снять скриншот после каждого шага
- поручить агенту написать в Messages или завести событие в Calendar
- пройти меню и магазин игры как быстрый смоук-тест
- пролистать длинный экран до нужного текста
- записать пройденные шаги, чтобы потом воспроизвести их повторно

## Примеры запросов агенту
- Через mirroir открой на iPhone мой Expo Go, зайди в LoginDemo и проверь экран входа с неверным паролем. Скриншот после каждого шага.
- Вызови `describe_screen` и скажи, что сейчас на экране iPhone.
- Пролистай настройки iPhone до пункта «Основные» и открой его.

## Похожие
- [argent-screenshot-diff](https://affpapa.org/nevibecode/skills/argent-screenshot-diff.md) — скилл · 31100 установок
- [terminal-phone](https://affpapa.org/nevibecode/skills/terminal-phone.md) — скилл · ★ 366 у репозитория
- [argent-ios-device-setup](https://affpapa.org/nevibecode/skills/argent-ios-device-setup.md) — скилл · 17100 установок
- [ios-device-automation](https://affpapa.org/nevibecode/skills/ios-device-automation.md) — скилл · 3500 установок
- [ios-mcp-jailbreak-automation](https://affpapa.org/nevibecode/skills/ios-mcp-jailbreak-automation.md) — скилл · 121 установка

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
