Mobile MCP — Установка & Живое демо

Зачем использовать

Ключевые функции

Платформонезависимость: одни и те же инструменты для iOS и Android
Работает с симуляторами, эмуляторами и реальными устройствами
Скриншоты + иерархия представлений как эквивалент DOM
Установка APK/IPA по URL или локальному пути
Не требует экспертизы в мобильном тестировании

Живое демо

Как выглядит на практике

mobile-mcp.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mobile-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "mobile-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@mobilenext/mobile-mcp@latest"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp@latest

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Mobile MCP

Smoke-тест приложения на iOS и Android по одному промпту

👤 Мобильные QA и разработчики без выделенной QA-команды ⏱ ~20 min intermediate

Когда использовать: Вы только что собрали билд и хотите убедиться, что флоу регистрации работает на обеих платформах.

Предварительные требования

Симулятор запущен — xcrun simctl boot "iPhone 16" и emulator -avd Pixel_7
Приложение установлено — Перетащите IPA/APK в симулятор или используйте инструмент install_app

Поток

Начать сессию

Use mobile-mcp. List all available devices.✓ Скопировано

→ iOS симулятор + Android эмулятор в списке
Запустить флоу

On both devices in parallel: open my app, tap "Sign Up", enter [email protected] / password123, tap Continue. Screenshot each step.✓ Скопировано

→ Последовательность скриншотов с обоих устройств
Проверить

On each device, is the "Verify your email" screen visible? If not, report what you see.✓ Скопировано

→ Результат pass/fail по каждой платформе с доказательствами

Итог: Отчёт pass/fail со скриншотами для обеих платформ за 2 минуты.

Подводные камни

Тестовый аккаунт блокируется антиспам-системой — Используйте одноразовые email для каждого билда; ротируйте тестовые аккаунты

Сочетать с: filesystem

Сгенерировать скриншоты для App Store под 5 размеров экрана

👤 Инди-разработчики, публикующие приложения в App Store ⏱ ~25 min intermediate

Когда использовать: Вам нужны скриншоты для 6.5", 6.7", 5.5" и вы не хотите делать это вручную.

Предварительные требования

Симуляторы для каждого нужного размера — Создайте через xcrun simctl с соответствующими типами устройств

Поток

Подготовить матрицу

Boot iPhone 15 Pro Max, iPhone 15, iPhone SE simulators. Install my app on each.✓ Скопировано

→ Все три устройства готовы с установленным приложением
Снять скриншоты

On each device, navigate to the 5 key screens (onboarding, feed, detail, settings, upgrade). Screenshot each at full resolution.✓ Скопировано

→ Скриншоты сохранены по устройствам с единым соглашением об именах

Итог: Скриншоты в полном комплекте размеров для App Store за один прогон.

Подводные камни

На скриншотах виден статус-бар симулятора — Используйте --status-bar-style=overridden или постобработку с crop

Сочетать с: filesystem

Комбинации

Сочетайте с другими MCP — эффект x10

mobile-mcp + filesystem

Сохранять скриншоты в версионированные QA-папки

Save every screenshot under /qa/$(date)/ with the test name.✓ Скопировано

mobile-mcp + xcodebuild

Собрать, установить и протестировать в одном флоу

Build the iOS app via xcodebuild, install it via mobile-mcp, run the smoke test.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
list_devices	none	Всегда первым — узнать, что доступно	free
launch_app	device_id, bundle_id	Открыть приложение на устройстве	free
tap	device_id, selector\|coords	Взаимодействие с кнопкой или элементом управления	free
type_text	device_id, text: str	Ввод текста в поле (поле должно быть сфокусировано заранее)	free
get_view_hierarchy	device_id	Выяснить, что сейчас на экране	free
screenshot	device_id, path?: str	Визуальная верификация	free

Стоимость и лимиты

Во что обходится

Квота API: Локально
Токенов на вызов: Иерархия представлений может быть 10k+ токенов; скриншоты в base64
Деньги: Бесплатно
Совет: Предпочитайте тапы по selector вместо дампа полной иерархии — экономит токены

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: device access (physical USB requires trust dialog)

Хранение учётных данных: Отсутствует

Исходящий трафик: Из MCP отсутствует; скриншоты передаются LLM-провайдеру при шеринге

Никогда не давайте: production device access with PII

Не тестируйте на устройствах с production-данными — используйте выделенные QA-аккаунты

Устранение неполадок

Частые ошибки и исправления

Список устройств пуст

Сначала запустите симулятор: xcrun simctl boot / emulator -avd X

Проверить: `xcrun simctl list | grep Booted`

tap_at_coords промахивается

Запустите get_view_hierarchy и используйте тап по selector — координаты ломаются при разных размерах экрана

Реальное устройство не подтверждено

На iOS: Настройки → Основные → Управление устройствами → Доверять. На Android: включите отладку по USB.

Альтернативы

Mobile MCP в сравнении

Альтернатива	Когда использовать	Компромисс
XcodeBuildMCP	Нужна только iOS-сборка и тестирование без кросс-платформенной UI-автоматизации	Нет Android; акцент на инструментарии сборки
Appium	Нужен полноценный CI-grade фреймворк мобильного тестирования	Гораздо сложнее в настройке; не нативный для MCP

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills