Каталог MCP
martingeidobler/android-mcp-server

martingeidobler/android-mcp-server

MCP сервер для управления Android через ADB: AI ассистент видит экран, тапает элементы, читает логи и устанавливает приложения. Включает 25 инструментов для отладки и тестирования без модификации кода. Полезен Android-разработчикам и тестировщикам.

README

25 инструментов

Версии

Установить сервер

Android MCP Server

MCP server for controlling Android emulators and devices via ADB. Gives AI assistants the ability to see, interact with, and debug Android apps — taking screenshots, tapping elements, reading logs, and documenting bugs.

npm Package | GitHub | Issues

ezgif-3bbb68e918812643 ^ Sped up for better viewing. More demos and test cases.

Features

25 tools for complete Android device control
Screenshot capture with intelligent compression (Sharp-based, max 1280px)
UI tree inspection — read element hierarchy with bounds, text, resource IDs, and state
Touch automation — tap, swipe, scroll, type text, press hardware keys
Element targeting — find and tap elements by resource-id, text, or content-desc
App lifecycle — install APKs, launch apps, inspect current activity
Logcat integration — filter by package, log level, or timestamp
Device management — list devices, start emulators, get device info
Compound actions — tap_and_wait combines tap + settle + UI tree in one round trip
Persistent ADB shell — reuses a single shell session for faster command execution
Device info caching — queries device properties once per session
Multi-device support — target specific devices by ID
Zero app modifications — works with any Android app via ADB, no SDK integration needed

Инструменты были проиндексированы: 11.09.2026

adb_shell

Выполняет произвольную команду ADB shell.

Параметры

commandstringобязательный
Shell command to execute on the device
device_idstring
Device ID (optional if only one device)

clear_logs

Очищает буфер Logcat. Вызывает эту команду перед воспроизведением ошибки, чтобы получить чистые логи.

Параметры

device_idstring
Device ID (optional if only one device)

double_tap

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

Параметры

device_idstring
Device ID (optional if only one device)
interval_msnumber
Interval between taps in ms (default 100)
xnumberобязательный
X coordinate
ynumberобязательный
Y coordinate

get_current_activity

Получает текущее отображаемое приложение и Activity.

Параметры

device_idstring
Device ID (optional if only one device)

get_device_info

Получает сведения об устройстве: модель, производитель, версия Android, уровень API, размер экрана и DPI.

Параметры

device_idstring
Device ID (optional if only one device)

get_logs

Получает вывод logcat с устройства. Используется для поиска сбоев, исключений и ошибок после воспроизведения бага.

Параметры

device_idstring
Device ID (optional if only one device)
levelenum
Minimum log level: V(erbose), D(ebug), I(nfo), W(arn), E(rror), F(atal)
linesnumber
Number of recent log lines to return (default 200)
package_namestring
Filter logs by app package name (e.g., com.example.app)
sincestring
Show logs since timestamp (e.g., '2024-01-15 10:30:00.000')

get_ui_tree

Получает иерархию UI-элементов текущего экрана. Возвращает интерактивные элементы с их bounds, текстом, resource IDs и состоянием. Используйте это для поиска элементов перед нажатием.

Параметры

device_idstring
Device ID (optional if only one device)

install_apk

Устанавливает APK-файл на устройство

Параметры

apk_pathstringобязательный
Local path to the APK file
device_idstring
Device ID (optional if only one device)

launch_app

Запускает Android-приложение по имени пакета.

Параметры

activitystring
Activity to launch (optional - launches default if omitted)
device_idstring
Device ID (optional if only one device)
package_namestringобязательный
App package name (e.g., com.android.settings)

list_avds

Перечисляет доступные Android Virtual Devices

Параметры

Без параметров.

list_devices

Выводит список подключенных Android-устройств и эмуляторов

Параметры

Без параметров.

long_press

Выполняет долгое нажатие по координатам экрана. Полезно для контекстных меню, маркеров перетаскивания и взаимодействий с удержанием.

Параметры

device_idstring
Device ID (optional if only one device)
duration_msnumber
Hold duration in ms (default 1000)
xnumberобязательный
X coordinate
ynumberобязательный
Y coordinate

multi_tap

Нажимает на одни и те же координаты несколько раз с фиксированным интервалом. Используйте для спам-нажатий, увеличения счётчиков или тестирования быстрых повторяющихся действий.

Параметры

countintegerобязательный
Number of taps to perform
device_idstring
Device ID (optional if only one device)
interval_msnumber
Interval between taps in ms (default 100)
xnumberобязательный
X coordinate
ynumberобязательный
Y coordinate

press_key

Нажмите аппаратную или программную клавишу

Параметры

device_idstring
Device ID (optional if only one device)
keyenumобязательный
Key to press

pull_file

Извлекает файл с Android-устройства в локальную файловую систему.

Параметры

device_idstring
Device ID (optional if only one device)
local_pathstringобязательный
Local path to save the file to
remote_pathstringобязательный
Path on the device (e.g., /sdcard/somefile.txt)

screenshot

Делает скриншот Android-устройства. Возвращает изображение для визуального анализа. Опционально сохраняет в файл по указанному пути.

Параметры

device_idstring
Device ID (optional if only one device)
save_pathstring
Local file path to save the screenshot PNG (optional)

scroll_to_element

Многократно прокручивает вниз, пока элемент, соответствующий заданным критериям, не станет видимым.

Параметры

byenumобязательный
How to find the element
device_idstring
Device ID (optional if only one device)
max_scrollsnumber
Maximum scroll attempts (default 10)
valuestringобязательный
Value to match

start_emulator

Запускает эмулятор Android. Ожидает до 60 секунд его готовности.

Параметры

avd_namestringобязательный
Name of the AVD to start (from list_avds)

swipe

Выполняет жест смахивания на экране.

Параметры

device_idstring
Device ID (optional if only one device)
duration_msnumber
Swipe duration in ms (default 300)
end_xnumberобязательный
End X coordinate
end_ynumberобязательный
End Y coordinate
start_xnumberобязательный
Start X coordinate
start_ynumberобязательный
Start Y coordinate

tap

Нажимает по указанным координатам экрана.

Параметры

device_idstring
Device ID (optional if only one device)
xnumberобязательный
X coordinate
ynumberобязательный
Y coordinate

tap_and_wait

Нажимает элемент, затем ожидает стабилизации UI и возвращает новое дерево UI. Объединяет tap, wait и get_ui_tree в одну быструю операцию.

Параметры

byenumобязательный
How to find the element to tap
device_idstring
Device ID (optional if only one device)
valuestringобязательный
Value to match
wait_msnumber
Time to wait for UI to settle after tap (default 1000ms)

tap_element

Нажимает элемент UI по его resource-id, text или content-desc. Находит элемент в дереве UI и нажимает его центр.

Параметры

byenumобязательный
How to find the element
device_idstring
Device ID (optional if only one device)
valuestringобязательный
Value to match

tap_sequence

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

Параметры

device_idstring
Device ID (optional if only one device)
stepsobject[]обязательный
Steps to execute in order

type_text

Вводит текст в текущее активное поле ввода

Параметры

device_idstring
Device ID (optional if only one device)
textstringобязательный
Text to type

wait_for_element

Ожидает появления элемента интерфейса на экране. Опрашивает каждые 500 мс.

Параметры

byenumобязательный
How to find the element
device_idstring
Device ID (optional if only one device)
timeout_msnumber
Timeout in ms (default 10000)
valuestringобязательный
Value to match

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "android-mcp-server"
  ],
  "env": {
    "ANDROID_HOME": "/path/to/android/sdk"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

FAQ

Для чего этот сервер?

Этот MCP-сервер даёт AI-ассистентам прямой доступ к Android-устройствам и эмуляторам через ADB. Он делает скриншоты, читает интерфейс, нажимает на кнопки, вводит текст и собирает логи. Разработчику не нужно трогать приложение: сервер работает через ADB и подходит для тестирования, отладки и документирования багов прямо голосом или текстом.

Что он умеет?

Сервер управляет Android-эмуляторами и устройствами через ADB: показывает список устройств и виртуальных машин, запускает эмуляторы, устанавливает APK, запускает приложения и определяет текущую активность. Делает скриншоты, читает иерархию UI, тапает по координатам и элементам, свайпает, скроллит, печатает текст, жмет клавиши, выполняет последовательности действий. Ждет появления элементов, читает и очищает логи, тянет файлы, выполняет произвольные ADB-команды и собирает информацию об устройстве.

Информация о сервере

Номер в рейтинге: #192
Звезд на Github: 66
Форков на Github: 9
Загрузок: 5 156
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 07.09 в 01:02
Идентификатор: 52ekeMnIvBjkdpGe
Категории: Автоматизация приложений, Инструменты для разработчиков, Тестирование и QA