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, копирует файлы с устройства и сохраняет скриншоты на диск.

Настройка клиентов

cursor
{
    "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 для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники