adb-mcp — MCP-сервер для Claude Code: что делает и как установить
Управляет эмулятором или физическим устройством Android через adb. Снимает скриншоты, считывает интерфейс и запускает сборки Gradle.
claude mcp add adb-mcp-android-emulator-and-device-control-over-adb -- docker run -i --rm ghcr.io/iksnerd/adb-mcp:0.24.3Что делает adb-mcp: Android emulator and device control over adb
Сервер даёт агенту 80 инструментов для работы с Android по протоколу MCP через stdio. Агент умеет запускать виртуальные устройства AVD, передавать клики и жесты через tap_on_text, считывать структуру экрана в describe_ui и просматривать logcat.
Координаты элементов возвращаются в реальных пикселях экрана. Это избавляет модель от необходимости угадывать точки нажатия по картинке. Снимки экрана делаются через exec-out screencap, поэтому файлы не бьются из-за символов перевода строк CRLF, а размер картинки сразу подгоняется под требования анализаторов изображений.
Для работы нужен установленный Android SDK с пакетами platform-tools и emulator, а также настроенный образ AVD. Без заданных переменных $ANDROID_HOME или явного флага --sdk сервер не сможет обнаружить утилиты разработчика.
Какие задачи решает
- снять скриншот экрана Android без битых байтов CRLF
- получить точные координаты элементов интерфейса через describe_ui
- передать нажатия и жесты на виртуальное устройство
- запустить сборку или прогон тестов через Gradle
- прочитать системный журнал logcat для разбора падений
Примеры запросов агенту
- Запусти эмулятор Android и сделай снимок экрана
- Найди кнопку через describe_ui и нажми на неё с помощью tap_on_text
- Собери проект через Gradle и проверь ошибки в logcat
Как установить adb-mcp: Android emulator and device control over adb
Командой платформы
claude mcp add adb-mcp-android-emulator-and-device-control-over-adb -- docker run -i --rm ghcr.io/iksnerd/adb-mcp:0.24.3Командой платформы
codex mcp add adb-mcp-android-emulator-and-device-control-over-adb -- docker run -i --rm ghcr.io/iksnerd/adb-mcp:0.24.3Файл настроек
{
"mcpServers": {
"adb-mcp-android-emulator-and-device-control-over-adb": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/iksnerd/adb-mcp:0.24.3"
]
}
}
}Файл настроек
{
"servers": {
"adb-mcp-android-emulator-and-device-control-over-adb": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/iksnerd/adb-mcp:0.24.3"
]
}
}
}Командой платформы
gemini mcp add adb-mcp-android-emulator-and-device-control-over-adb docker run -i --rm ghcr.io/iksnerd/adb-mcp:0.24.3По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о adb-mcp: Android emulator and device control over adb
Как установить adb-mcp: Android emulator and device control over adb в Claude Code?
Выполните команду claude mcp add adb-mcp-android-emulator-and-device-control-over-adb -- docker run -i --rm ghcr.io/iksnerd/adb-mcp:0.24.3.
Что делает этот MCP-сервер?
Он связывает модель с Android Debug Bridge. Это позволяет открывать эмуляторы, считывать дерево интерфейса, тапать по экрану и запускать сборки.
Нужен ли установленный Go для работы сервера?
Нет. Go версии 1.26 и выше нужен исключительно для ручной компиляции из исходников, а для запуска используются готовые бинарные файлы или Docker.
