mobai-mcp

mobai-mcp

MobAI-AppApache-2.0
208 звёзд18 форков
MobAI MCP — сервер для автоматизации мобильных устройств через ИИ-ассистентов. Он подключается к Android и iOS устройствам, эмуляторам и симуляторам и выполняет сценарии на специальном предметно-ориентированном языке (DSL). Вместо множества атомарных команд (тап, свайп, ввод) сервер принимает единый JSON-скрипт с последовательностью действий, условиями и проверками. Это сокращает количество обращений к ИИ и даёт возможность повторять шаги при ошибках прямо на стороне сервера. Сервер предназначен для разработчиков, тестировщиков и DevOps-инженеров, которые хотят управлять мобильными приложениями через голосовые или текстовые запросы к ИИ. Например, можно запустить приложение на реальном устройстве, сделать скриншот, установить APK или провести интеграционный тест без ручного скриптинга.
Ai-mlProductivity
Открыть на GitHub

Установка

npx -y mobai-mcp

Характеристики

Общее

  • СтатусСообщество
  • РазработчикMobAI-App
  • ЛицензияApache-2.0

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Список всех подключённых Android и iOS устройств, эмуляторов и симуляторов с детальной информацией о каждом.
  • Запуск и остановка моста автоматизации на выбранном устройстве — обязательный шаг перед любым взаимодействием.
  • Создание быстрых скриншотов низкого качества для визуального анализа ИИ (с указанием коэффициента масштабирования).
  • Сохранение полноразмерных скриншотов в PNG на диск для отчётов или отладки.
  • Установка, удаление и список установленных приложений по имени пакета или bundle ID.
  • Запуск приложения в отладочном режиме с записью stdout/stderr в лог-файл.
  • Выполнение DSL-сценария, который включает тапы, ввод текста, свайпы, ожидания, утверждения, веб-автоматизацию, сбор метрик и запись экрана.
  • Запуск .mob-файлов — готовых тестовых сценариев в формате MobAI.

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

  1. Установите сервер глобально через npx: npx -y mobai-mcp
  2. Добавьте конфигурацию в ваш MCP-клиент. Для Claude Desktop отредактируйте файл claude_desktop_config.json:
{ "mcpServers": { "mobai": { "command": "npx", "args": ["-y", "mobai-mcp"] } } }

Перезапустите клиент. Убедитесь, что приложение MobAI запущено локально на 127.0.0.1:8686.

Примеры запросов

  • «Покажи список всех подключённых устройств и выбери первое Android-устройство».
  • «Сделай скриншот экрана, определи, в каком приложении находится пользователь, и верни название».
  • «Установи APK-файл из /home/user/app.apk на устройство и запусти его».
  • «Напиши DSL-сценарий: открой приложение «Календарь», нажми кнопку «Создать событие», введи заголовок «Встреча» и установи время на завтра 15:00».

Технические детали

  • Язык: TypeScript
  • Транспорт: stdio
  • Лицензия: Apache 2.0
  • Зависимости: Node.js 18+ и MobAI desktop app
  • Совместимые клиенты: Claude Desktop, Claude Code, Cursor, Windsurf, Cline и любые другие MCP-совместимые инструменты

Поделиться