mobai-mcp

mobai-mcp — MCP-сервер сообщества (автор — MobAI-App). Автоматизация Android- и iOS-устройств, эмуляторов и симуляторов. Лицензия Apache-2.0.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
MobAI-App
Лицензия
Apache-2.0
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
typescript

Уровень риска: high

Управляет мобильным устройством, ставит и удаляет приложения, сохраняет снимки экрана и логи на диск.

Настройка клиентов

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"mobai\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mobai-mcp\"]\n    }\n  }\n}",
    "file": ".cursor/mcp.json",
    "lang": "json",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

MobAI MCP Server подключает ИИ-ассистента к MobAI — инструменту автоматизации мобильных устройств. Через него агент управляет Android- и iOS-устройствами, эмуляторами и симуляторами.

Главный инструмент — execute_dsl. Вместо десятков мелких команд (нажатие, свайп, ввод) сервер принимает JSON-сценарий: последовательность действий с условиями, проверками и ожиданиями. В сценарии доступны нажатия, ввод текста, свайпы, наблюдение за экраном, проверки, автоматизация веб-содержимого, метрики и запись экрана.

Вспомогательные инструменты:

  • устройства: список подключённых устройств, сведения об устройстве, запуск и остановка моста автоматизации, захват и освобождение устройства для сессии;
  • снимки экрана: быстрый уменьшенный снимок для анализа моделью и полноразмерный PNG на диск;
  • приложения: список установленных, установка .apk или .ipa из локального файла, удаление, запуск в режиме отладки с записью логов в файл;
  • тесты: поиск проектов с файлами .mob и запуск теста на устройстве с подстановкой параметров.

Ресурсы mobai://reference/device-automation и mobai://reference/testing описывают синтаксис сценариев и тестов — агенту стоит прочитать их до первого действия.

Кому подойдёт

  • Мобильным разработчикам: быстрая проверка сценариев в приложении на реальном устройстве или симуляторе.
  • Тестировщикам: написание и запуск тестов .mob силами агента.
  • Тем, кто автоматизирует рутину на телефоне через ассистента.

Похожие серверы — в категории разработка.

Установка

Что нужно:

  • Node.js 18 или новее;
  • запущенное приложение MobAI для компьютера с HTTP API на 127.0.0.1:8686;
  • подключённое Android- или iOS-устройство, эмулятор или симулятор.

Сервер запускается через npx -y mobai-mcp и работает по stdio.

Подключение к клиентам

Команда и конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

claude mcp add mobai -- npx -y mobai-mcp

Для Cursor конфиг добавляют в .cursor/mcp.json, для Claude Desktop на macOS — в ~/Library/Application Support/Claude/claude_desktop_config.json. Для Windsurf, Cline и других клиентов README предлагает общий конфиг с той же командой npx -y mobai-mcp.

Проверка

Попросите агента вызвать list_devices. В ответе должен быть список подключённых устройств. Если появляется ошибка соединения, проверьте, что приложение MobAI запущено и API доступен на 127.0.0.1:8686.

Примеры задач

Открой на iPhone-симуляторе «Настройки», перейди в Wi-Fi и проверь, что переключатель на месте.
Установи сборку app-debug.apk на эмулятор, запусти приложение и сохрани снимок главного экрана.

Перед любыми действиями с устройством агент должен вызвать start_bridge; мост на iOS может запускаться до минуты.

Риски

  • Управление устройством. Агент нажимает, вводит текст и запускает приложения на реальном устройстве. Используйте тестовое устройство или симулятор, а не личный телефон с аккаунтами.
  • Установка и удаление приложений. install_app ставит пакеты из локальных файлов, uninstall_app удаляет приложения вместе с данными.
  • Запись файлов. Снимки экрана сохраняются в /tmp/mobai/screenshots/, логи отладки — в файлы на диске.
  • Чтение файлов. Установка приложения принимает путь к локальному файлу.

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

Работает ли сервер без приложения MobAI?

Нет. Сервер обращается к HTTP API приложения MobAI на компьютере.

Почему почти всё делается одним инструментом?

Пакетный сценарий в execute_dsl выполняет много действий за один вызов и экономит контекст по сравнению с отдельными инструментами для каждого нажатия.

Где смотреть снимки экрана?

get_screenshot по умолчанию сохраняет файл в /tmp/mobai/screenshots/ и возвращает путь; откройте его средствами чтения файлов вашего ассистента.

Основы протокола — на странице что такое MCP-сервер.

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

commands

Сервер из UI-TARS-desktop для запуска произвольных команд.

Риск: medium Лицензия: Apache-2.0 ★ 39 555

Windows-MCP

Управление компьютером с Windows: окна, приложения, ввод и чтение экрана.

Риск: high Лицензия: MIT ★ 11 608

agent-device

Слой управления мобильными, веб-, ТВ- и десктопными приложениями для агентов.

Риск: medium Лицензия: MIT ★ 5 295

Источники