android-mcp-server
android-mcp-server — MCP-сервер сообщества (автор — martingeidobler). Управление Android через ADB: скриншоты и автоматизация интерфейса. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- martingeidobler
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- none
- ОС
- Не указана
- Языки
- typescript
Уровень риска: high
Выполняет произвольные команды ADB shell на устройстве, устанавливает APK, копирует файлы с устройства и сохраняет скриншоты на диск.
Настройка клиентов
{
"code": "{\n \"mcpServers\": {\n \"android\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"android-mcp-server\"],\n \"env\": {\n \"ANDROID_HOME\": \"/path/to/android/sdk\"\n }\n }\n }\n}",
"file": "~/.cursor/mcp.json",
"lang": "json",
"verified": "docs"
}
Что умеет
Android MCP Server управляет эмуляторами и устройствами Android через ADB. ИИ-ассистент может видеть приложения, взаимодействовать с ними и отлаживать их: делать скриншоты, нажимать на элементы, читать логи и документировать баги. Приложение менять не нужно: всё работает через ADB, без подключения SDK. Лицензия MIT.
25 инструментов:
- Устройства —
list_devices,list_avds,start_emulator(ждёт запуска до 60 секунд),get_device_info(модель, версия Android, уровень API, размер экрана, DPI). - Скриншоты и интерфейс —
screenshotсо сжатием до 1280 пикселей и необязательным сохранением на диск,get_ui_treeс иерархией элементов, координатами, текстом, идентификаторами ресурсов и состоянием. - Взаимодействие — нажатия по координатам и по элементу (resource-id, текст или content-desc), долгое и двойное нажатие, серия нажатий, цепочки действий
tap_sequence, ввод текста, клавиши, свайпы, прокрутка до элемента и ожидание элемента. Составное действиеtap_and_waitнажимает, ждёт, пока интерфейс успокоится, и возвращает новое дерево за один запрос. - Диагностика —
get_logs(logcat с фильтром по пакету, уровню и времени) иclear_logs. - Приложения —
launch_app,install_apk,get_current_activity,pull_file(копирование файла с устройства на компьютер) иadb_shellдля произвольных команд ADB shell.
Сервер держит одну постоянную сессию ADB shell для скорости, кэширует свойства устройства на сессию и поддерживает несколько устройств сразу. Скриншоты снимаются в памяти, сжимаются и возвращаются в base64.
Кому подойдёт
- Android-разработчикам и тестировщикам — smoke-тесты, проверка экранов по макетам и сбор данных для баг-репортов.
Похожие серверы — в категории разработка.
Установка
Нужны Node.js 18+, Android SDK с platform-tools (ADB) и эмулятором, а также запущенный эмулятор или подключённое устройство. Сервер сам находит SDK в ~/Library/Android/sdk на macOS или по ANDROID_HOME; если SDK лежит в другом месте, задайте ANDROID_HOME в конфиге. Сервер запускается через npx -y android-mcp-server.
Подключение к клиентам
Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.
claude mcp add --scope user android -- npx -y android-mcp-serverВ Claude Code флаг --scope project ограничит сервер текущим проектом. Для Claude Desktop файл — ~/Library/Application Support/Claude/claude_desktop_config.json на macOS или %APPDATA%\Claude\claude_desktop_config.json на Windows. Для VS Code README указывает .vscode/settings.json, для Cursor — ~/.cursor/mcp.json. Есть также варианты для Windsurf и общего .mcp.json проекта.
Проверка
Запустите эмулятор и попросите показать список устройств и сделать скриншот.
Примеры задач
Очисти логи, открой экран настроек, нажми «Сохранить», затем покажи ошибки из логов и скриншот.Установи APK, запусти приложение и пройди по основным экранам, проверяя, что ничего не падает.Риски
- Произвольные команды.
adb_shellвыполняет любые команды на устройстве — используйте тестовые эмуляторы, а не личный телефон. - Запись на диск.
pull_fileи сохранение скриншотов пишут файлы на компьютер. - Данные приложения. Логи и скриншоты попадают в ИИ-клиент.
Частые вопросы
Нужно ли менять приложение?
Нет, всё работает через ADB.
Работает ли с реальными телефонами?
Да, с подключёнными по ADB устройствами.
Можно ли управлять несколькими устройствами?
Да, указывайте идентификатор устройства.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
GitHub MCP Server
Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.
Git
Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.
GitDiagram
Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.
git-mcp
Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.