Android MCP Server — управление Android через ADB
Android MCP Server
MCP-сервер на Python: агент делает снимок экрана Android-устройства, читает кликабельные элементы интерфейса и выполняет команды ADB
- 811 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- execute_adb_command выполняет произвольные команды ADB на подключенном устройстве, в том числе установку и удаление приложений
- Снимки экрана и список элементов могут содержать личные данные с телефона
Установка
- Работает в
Ручная установка
git clone https://github.com/minhalvp/android-mcp-server.git && cd android-mcp-server && uv python install 3.11 && uv syncШаги из README. ADB должен быть установлен заранее.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- execute_adb_command выполняет произвольные команды ADB на подключенном устройстве, в том числе установку и удаление приложений
- Снимки экрана и список элементов могут содержать личные данные с телефона
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер связывает MCP-клиент с телефоном или планшетом через Android Debug Bridge. У агента пять инструментов: get_screenshot возвращает снимок экрана, get_uilayout выдает список кликабельных элементов с текстом, описанием, границами и координатами центра, get_packages перечисляет установленные пакеты, get_package_action_intents показывает действия из таблицы Activity Resolver для пакета, execute_adb_command выполняет произвольную команду ADB. Если подключено одно устройство, сервер выберет его сам. При нескольких устройствах нужен файл config.yaml, где в поле device.name указан серийный номер из вывода adb devices. Без настройки при нескольких устройствах сервер покажет ошибку со списком доступных.
Для кого. Для разработчиков мобильных приложений и тестировщиков, которые хотят дать Claude Desktop или Cursor управление Android-устройством.
Подходит, если
- Нужно посмотреть, что сейчас на экране тестового телефона, и описать кнопки с координатами
- Агент должен найти, какие пакеты установлены на устройстве
- Надо выполнить команду adb из диалога: например, открыть экран или прочитать настройку
- Нужно узнать, какие intent-действия объявляет пакет
- К компьютеру подключено несколько устройств, и нужное задается серийным номером в config.yaml
Не подходит, если
- Нужны нажатия и ввод текста как отдельные инструменты: в списке их нет, управлять приходится через execute_adb_command
- Нужен iOS: сервер работает только с Android
- Основная цель эмулятор Android: в README он помечен как непроверенный
- Нужен готовый пакет из реестра: установка идет через git clone и uv sync
- Устройство нельзя подключать к ADB по политике безопасности
Пример запроса к агенту
Сделай снимок экрана телефона и скажи, какие кликабельные элементы на нем естьMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Нужны Python 3.x, установленный и настроенный ADB и инструмент uv; README предлагает uv python install 3.11. Установка идет через git clone, готового пакета в реестре нет. Эмулятор Android в README назван непроверенным. Лицензия Apache-2.0, последний коммит от 28 мая 2025 года. Отдельных инструментов для нажатий и ввода текста нет, такие действия выполняются через execute_adb_command. Тесты лежат в папке tests: они проверяют менеджер ADB, конфигурацию и интеграцию.
Как отключить. Удалите блок android из mcpServers в конфигурации клиента и перезапустите клиент. Каталог с клонированным репозиторием можно убрать вручную.
Частые вопросы
Как подключить Android к Claude через MCP?
Склонируйте репозиторий, выполните uv sync и добавьте в claude_desktop_config.json сервер android с командой uv и аргументами --directory, путь к каталогу, run, server.py. На устройстве должна быть включена отладка по ADB, а adb devices должен показывать его.
Что делать, если подключено несколько устройств?
Скопируйте config.yaml.example в config.yaml и впишите серийный номер из adb devices в device.name. Без этого сервер выдаст ошибку со списком устройств.
Какие инструменты есть у сервера?
Пять: get_screenshot, get_uilayout, get_packages, get_package_action_intents и execute_adb_command.
Чем отличается от других Android MCP в каталоге?
Этот сервер минимален и построен вокруг ADB: снимок, список элементов, пакеты и произвольная команда. Запись `cursortouch` ведет навигацию по приложениям и авто-тесты, а `mobile-mcp` управляет и iOS, и Android.
Нужен ли файл config.yaml?
Нет, он необязателен. Если подключено ровно одно устройство, сервер выберет его сам. Файл нужен только при нескольких устройствах: в device.name указывают серийный номер из adb devices.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для управления Android-устройством через ADB: навигация по приложениям, ввод и авто-тесты
Android Remote Control MCP
android-remote-control-mcp
Приложение Android, которое превращает телефон или эмулятор в сервер MCP: службы доступности и снимки экрана
MCP-сервер для управления iOS и Android: симуляторы, эмуляторы и реальные устройства через дерево доступности и скриншоты
Android-эмулятор в Docker с MCP-сервером: агент управляет устройством по adb, открывает приложения и страницы, нажимает кнопки
Google Play Developer MCP
google-play-developer-mcp
MCP-сервер для Google Play Console: релизы и треки, поэтапная раскатка, магазинные страницы, отзывы и подписки из чата с агентом
MCP-сервер, который принимает команды на обычном языке и управляет iOS-симулятором через idb: приложения, нажатия, логи
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Android MCP Server — управление Android через ADB (эта запись) | нет | не нужна | 811 | |
| Android MCP | нет | не нужна | 907 | другой проект: навигация по приложениям, ввод и авто-тесты |
| Mobile MCP | нет | не нужна | 10 095 | управление iOS и Android через дерево доступности и скриншоты |
| SimUtil — MCP для эмуляторов и симуляторов | нет | не нужна | 1 201 | десктопное приложение и CLI для Android-эмуляторов |
Коротко о README
README объясняет, как установить uv и зависимости, как выбрать устройство автоматически или через config.yaml и как прописать сервер в Claude Desktop для macOS и Windows. Есть таблица сценариев выбора устройства и описания пяти инструментов в виде сигнатур Python.