Icemoon — MCP-сервер для Claude Code: управление реальным iPhone
Локальный MCP-сервер, через который ИИ читает экран физического iPhone и выполняет на нём многошаговые задачи касаниями и свайпами.
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Что делает 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 сам по себе ничего не делает: не найдёт лицензированное приложение — напишет, где его взять, и выйдет.
Какие задачи решает
- пройти онбординг свежеустановленного приложения и снять скриншот каждого экрана
- прогнать сохранённый сценарий на всех подключённых телефонах и найти сбойный
- дойти до экрана оплаты в приложении и записать видео прохождения
- поставить повторяющуюся задачу на календарь и запускать её на нескольких устройствах
- подставить код 2FA при входе в аккаунт прямо во время сценария
Примеры запросов агенту
- Открой настройки на моём iPhone, включи режим «Не беспокоить» и проверь, что он держится.
- Пройди онбординг приложения, которое я только что поставил, и сохрани скриншот каждого экрана.
- Запусти сохранённый сценарий «morning report» на всех подключённых телефонах и скажи, если какое-то устройство упало.
Как установить Icemoon — control a real iPhone with AI
Командой платформы
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 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Вместо <…> подставьте свои значения
Файл настроек
{
"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>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"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 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Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Icemoon — control a real iPhone with AI
Как установить Icemoon в Claude Code?
Добавьте сервер командой claude mcp add automation-studio -- npx -y icemoon-mcp. Если приложение лежит не в /Applications/AutomationStudio.app или дашборд слушает другой адрес, используйте вариант с переменными: `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`.
Что делает Icemoon?
Даёт агенту доступ к экрану и вводу физического iPhone: он видит элементы интерфейса, нажимает, свайпает, печатает и выполняет цепочки шагов. Всё идёт через локальный сервер на Mac, устройства подключены по USB.
Что нужно, чтобы сервер заработал?
Mac на Apple Silicon с macOS 13 или новее, установленное и активированное приложение Icemoon с планом Farm или Scale, плюс подключённый по USB iPhone. Приложение должно быть запущено: оно принимает подключения на локальном дашборде.
