Android MCP
MCP-сервер для управления Android-устройством через ADB: навигация по приложениям, ввод и авто-тесты
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Инструмент shell выполняет произвольные команды на устройстве
- Сервер может выполнять любые действия в интерфейсе устройства
Установка
Ручная установка
{
"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-агента
Скилл Пола Хадсона для ревью и написания SwiftUI под iOS 26: устаревшие API, поток данных, навигация, доступность, производительность
Официальные скиллы Expo для агентов: сборка, деплой, обновление и отладка приложений на Expo и EAS
Открытая модель и фреймворк агента для смартфона: видит экран и сам нажимает в приложениях Android, HarmonyOS и iOS по текстовой команде