Android MCP

MCP-сервер для управления Android-устройством через ADB: навигация по приложениям, ввод и авто-тесты

MCP-сервер

Высокий риск

Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.

Почему такой уровень

  • Инструмент shell выполняет произвольные команды на устройстве
  • Сервер может выполнять любые действия в интерфейсе устройства
Все причины и проверки

cursortouch/android-mcp

Установка

Ручная установка

{
  "mcpServers": {
    "android-mcp": {
      "command": "uvx",
      "args": [
        "--python",
        "3.13",
        "android-mcp"
      ]
    }
  }
}

Рекомендуемый способ через uvx, зависимости ставить вручную не нужно.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер связывает агента с Android-устройством или эмулятором через ADB и Accessibility API. Агент читает состояние экрана и активные приложения, запускает приложения, нажимает и делает долгие нажатия, вводит текст, свайпает, перетаскивает, жмет аппаратные кнопки, снимает уведомления и выполняет shell-команды на устройстве. Управление идет по дереву интерфейса, без распознавания по картинке. Устройство выбирается автоматически или задается по серийному номеру и адресу через флаги и переменные окружения, поддерживается подключение по USB и по Wi-Fi.

Для кого. Для мобильных разработчиков и QA-инженеров, которым нужна автоматизация действий на Android через агента.

Подходит, если

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

Не подходит, если

  • Нет настроенного ADB и включенной отладки по USB
  • Нужно гонять недоверенные промпты на личном рабочем устройстве

Пример запроса к агенту

Открой приложение настроек, зайди в раздел о телефоне и покажи версию Android

Ограничения

Нужны Python 3.13, установленный ADB и устройство или эмулятор на Android 10 или новее. Выбор устройства настраивается флагами и переменными ANDROID_MCP_DEVICE, ANDROID_MCP_CONNECTION, ANDROID_MCP_HOST. Инструмент shell выполняет произвольные команды на устройстве, а сам сервер может делать любые действия в интерфейсе, поэтому README советует использовать эмуляторы и тестовые устройства при работе с недоверенными агентами.

Как отключить. Уберите запись сервера из конфигурации MCP-клиента и перезапустите его.

MCP

Транспорт
stdio
Авторизация
не нужна
Переменные окружения
Переменные окружения
ANDROID_MCP_DEVICE
Серийный номер устройства или адрес host:port для явного выбора.
ANDROID_MCP_CONNECTION
Тип подключения: auto, usb или wifi.
ANDROID_MCP_HOST
Адрес устройства по Wi-Fi, порт 5555 добавляется автоматически.
SCREENSHOT_QUANTIZED
Значение true уменьшает скриншот, чтобы сократить число входных токенов.

Проверка безопасности

  • Инструмент shell выполняет произвольные команды на устройстве
  • Сервер может выполнять любые действия в интерфейсе устройства

Коротко о README

README описывает мост между агентом и Android через ADB и Accessibility API для навигации по приложениям, работы с интерфейсом и авто-тестов без CV-пайплайна. Показаны проверка ADB, запуск через uvx или uv, конфигурации для Claude Desktop и OpenCode, выбор устройства по USB и Wi-Fi. Перечислены инструменты по состоянию, нажатиям, вводу, свайпам, кнопкам и shell, а также переменные окружения. Есть предупреждение о запуске в контролируемой среде. Лицензия MIT.

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

Нужна ли модель компьютерного зрения?

Нет, сервер работает по дереву интерфейса через Accessibility API, а не по распознаванию картинки.

Как выбрать конкретное устройство?

Флагами --device, --wifi, --usb или переменными окружения ANDROID_MCP_DEVICE, ANDROID_MCP_CONNECTION, ANDROID_MCP_HOST.

Официальный

MCP-сервер и CLI от Sentry для сборки, запуска и тестирования iOS и macOS проектов Xcode из AI-агента

MCP-серверСредний рискБез VPN6,4 тыс.Звезды репозитория
Выбор редакции

Скилл Пола Хадсона для ревью и написания SwiftUI под iOS 26: устаревшие API, поток данных, навигация, доступность, производительность

СкиллНизкий рискБез VPN4,9 тыс.Звезды репозитория
Выбор редакции

Официальные скиллы Expo для агентов: сборка, деплой, обновление и отладка приложений на Expo и EAS

ПлагинСредний риск2,6 тыс.Звезды репозитория

Открытая модель и фреймворк агента для смартфона: видит экран и сам нажимает в приложениях Android, HarmonyOS и iOS по текстовой команде

CLIВысокий риск26,3 тыс.Звезды репозитория
Foxx AIAndroid MCP

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.