Mobile MCP

mobile-next/mobile-mcp· Проверено 12.11.2026· 10,5 тыс.на GitHub

Даёт агенту управлять телефоном: симулятором iOS, эмулятором Android или реальным устройством по USB. Агент ставит и запускает приложения, нажимает, листает, печатает и читает элементы экрана.

Как подключить

Что сделать до подключения

1

Node.js 20 или новее

2

Для Android: Android Platform Tools (adb) и запущенный эмулятор или телефон с включённой отладкой по USB

3

Для iOS: Xcode command line tools и запущенный симулятор или iPhone, подключённый по USB и доверенный

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio mobile \
  -- npx -y @mobilenext/mobile-mcp@latest

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Инструменты сервера

mobile_list_available_devicesпоказывает доступные устройства
mobile_list_elements_on_screenчитает элементы экрана
mobile_take_screenshotснимает экран
mobile_click_on_screen_at_coordinatesнажимает по точке или элементу
mobile_long_press_on_screen_at_coordinatesделает долгое нажатие
mobile_swipe_on_screenлистает экран
mobile_type_keysвводит текст
mobile_press_buttonнажимает HOME, BACK и другие кнопки
mobile_open_urlоткрывает адрес в браузере
mobile_list_appsпоказывает установленные приложения
mobile_launch_appзапускает приложение
mobile_terminate_appостанавливает приложение
mobile_install_appставит .apk, .ipa или .app
mobile_clear_app_dataсбрасывает данные приложения
mobile_set_orientationповорачивает экран
mobile_set_locationподменяет координаты GPS
mobile_start_screen_recordingначинает запись экрана
mobile_get_device_logsсобирает логи устройства
mobile_list_crashesпоказывает отчёты о падениях
mobile_batch_commandsвыполняет несколько действий разом

Показано 20 из 34.

Что попросить агента

«Покажи доступные устройства»Агент вызовет mobile_list_available_devices
«Скачай бесплатное приложение <название>, зарегистрируйся с моей почтой и найди, как запустить <функция>»Агент откроет магазин приложений, пройдёт шаги через mobile_list_elements_on_screen, mobile_click_on_screen_at_coordinates и mobile_type_keys
«Открой приложение погоды, посмотри прогноз на завтра для <город> и отправь сводку в Telegram контакту <имя>»Агент вызовет mobile_launch_app, прочитает экран через mobile_list_elements_on_screen и наберёт сообщение через mobile_type_keys
«Приложение <название> упало: найди отчёт о падении и покажи логи»Агент вызовет mobile_list_crashes, затем mobile_get_crash и mobile_get_device_logs

Для каких задач

Пройти сценарий в приложении на iOS и Android одними и теми же командами
Заполнить форму или пройти регистрацию в приложении
Собрать логи и отчёт о падении после сбоя
Записать видео экрана с прохождением сценария
Превратить пройденный агентом сценарий в тест Mobilewright для CI

Ограничения

!

Устройство или эмулятор нужно запустить заранее: пока их нет, список устройств пустой

!

Сервер собирает анонимную статистику через PostHog и Scarf; отключается переменной MOBILEMCP_DISABLE_TELEMETRY=1

!

В режиме --listen без переменной MOBILEMCP_AUTH сервер принимает подключения без пароля

!

Облачные устройства Mobile Next Cloud требуют входа в аккаунт этого сервиса

Если не работает

Агент получает пустой список устройств
Запустите симулятор или эмулятор до работы: на iOS, например, xcrun simctl boot "iPhone 16", на Android — эмулятор через avdmanager или emulator.
После обновления клиент не подключается к --listen по SSE
Старый транспорт HTTP+SSE убран. Подключайтесь через Streamable HTTP к http(s)://<хост>:<порт>/mcp.
mobile_open_url не открывает ссылку со своей схемой
Нестандартные схемы адресов заблокированы. Разрешите их переменной MOBILEMCP_ALLOW_UNSAFE_URLS=1.

Частые вопросы

Как проверить, что всё подключилось?
Попросите агента: list available devices. В ответе должны быть запущенные симуляторы, эмуляторы и подключённые телефоны. Пустой список значит, что ни одно устройство не запущено.
Нужна модель со зрением?
Нет, сервер читает приложение через дерево доступности и к скриншотам с координатами переходит только при необходимости. Картиночные токены на этом не тратятся.
Можно ли настроить сразу все клиенты?
Да: npx @mobilenext/mobile-mcp@latest install найдёт установленные клиенты, среди них Claude Code, Codex, Cursor, VS Code и Gemini CLI, и предложит выбрать. С флагом --yes настроит все.
Как запустить сервер по HTTP?
Флагом --listen 3000, адрес для клиента — http://<хост>:3000/mcp. Чтобы требовать токен, задайте MOBILEMCP_AUTH: тогда каждый запрос должен нести заголовок Authorization: Bearer.
Работает ли сервер из России?
Сервер работает на вашем компьютере и управляет вашими устройствами, ключи не нужны; облачные телефоны Mobile Next Cloud — отдельный сервис со своим аккаунтом.

Похожие серверы