# Icemoon — control a real iPhone with AI

Локальный MCP-сервер, через который ИИ читает экран физического iPhone и выполняет на нём многошаговые задачи касаниями и свайпами.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: icemoon-dev
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/icemoon-dev/icemoon-mcp
- Обновлён: 2026-08-03
- HTML: https://affpapa.org/nevibecode/mcp/icemoon-control-a-real-iphone-with-ai

## Что делает

Сервер поднимается на вашем Mac и по stdio отдаёт агенту инструменты для работы с подключёнными по USB телефонами. Экран читается как структура: кнопки, подписи и поля приходят с идентификаторами и координатами, а не картинкой. Жесты синтезируются с неравномерной траекторией и таймингом, ввод идёт через настоящую клавиатуру iOS. Взлом прошивки не нужен, обычный iOS подходит.

Инструментов много: обнаружение устройств, чтение экрана, тапы и свайпы, запуск приложений, пакетные последовательности, планы с живым прогрессом на дашборде, буфер обмена, запись видео, отложенные задачи и генерация кодов 2FA. Соединения держатся в пуле, поэтому агент переключается между телефонами или адресует конкретный через `port=`.

Сам сервер поставляется внутри приложения Icemoon: приложение коммерческое, сервер закрытый, репозиторий — только документация. Нужен macOS 13 и новее на Apple Silicon, активированная подписка Icemoon уровня Farm или Scale и хотя бы один телефон на кабеле. Запускается приложение с дашбордом на `http://127.0.0.1:8088`, поэтому без него сервер работать не будет. Лаунчер `icemoon-mcp` сам по себе ничего не делает: не найдёт лицензированное приложение — напишет, где его взять, и выйдет.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `ICEMOON_APP`, `ICEMOON_DASHBOARD_URL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env ICEMOON_APP=<ICEMOON_APP> --env ICEMOON_DASHBOARD_URL=<ICEMOON_DASHBOARD_URL> --transport stdio icemoon-control-a-real-iphone-with-ai -- npx -y icemoon-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add icemoon-control-a-real-iphone-with-ai --env ICEMOON_APP=<ICEMOON_APP> --env ICEMOON_DASHBOARD_URL=<ICEMOON_DASHBOARD_URL> -- npx -y icemoon-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "icemoon-control-a-real-iphone-with-ai": {
            "command": "npx",
            "args": [
                "-y",
                "icemoon-mcp"
            ],
            "env": {
                "ICEMOON_APP": "<ICEMOON_APP>",
                "ICEMOON_DASHBOARD_URL": "<ICEMOON_DASHBOARD_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "icemoon-control-a-real-iphone-with-ai": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "icemoon-mcp"
            ],
            "env": {
                "ICEMOON_APP": "<ICEMOON_APP>",
                "ICEMOON_DASHBOARD_URL": "<ICEMOON_DASHBOARD_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e ICEMOON_APP=<ICEMOON_APP> -e ICEMOON_DASHBOARD_URL=<ICEMOON_DASHBOARD_URL> icemoon-control-a-real-iphone-with-ai npx -y icemoon-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- пройти онбординг свежеустановленного приложения и снять скриншот каждого экрана
- прогнать сохранённый сценарий на всех подключённых телефонах и найти сбойный
- дойти до экрана оплаты в приложении и записать видео прохождения
- поставить повторяющуюся задачу на календарь и запускать её на нескольких устройствах
- подставить код 2FA при входе в аккаунт прямо во время сценария

## Примеры запросов агенту
- Открой настройки на моём iPhone, включи режим «Не беспокоить» и проверь, что он держится.
- Пройди онбординг приложения, которое я только что поставил, и сохрани скриншот каждого экрана.
- Запусти сохранённый сценарий «morning report» на всех подключённых телефонах и скажи, если какое-то устройство упало.

## Похожие
- [iPhone Use](https://affpapa.org/nevibecode/mcp/iphone-use.md) — MCP-сервер · ★ 374
- [ios-device-automation](https://affpapa.org/nevibecode/skills/ios-device-automation.md) — скилл · 3300 установок
- [iPhone Mirror](https://affpapa.org/nevibecode/mcp/iphone-mirror.md) — MCP-сервер · ★ 8
- [argent-ios-device-setup](https://affpapa.org/nevibecode/skills/argent-ios-device-setup.md) — скилл · 11000 установок
- [argent-ios-device-interact](https://affpapa.org/nevibecode/skills/argent-ios-device-interact.md) — скилл · 11000 установок
- [iphone-duo-camera](https://affpapa.org/nevibecode/skills/iphone-duo-camera.md) — скилл · 500 установок

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