# adb-mcp: Android emulator and device control over adb

Управляет эмулятором или физическим устройством Android через adb. Снимает скриншоты, считывает интерфейс и запускает сборки Gradle.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11
- Автор: iksnerd
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/iksnerd/adb-mcp
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/mcp/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` сервер не сможет обнаружить утилиты разработчика.

## Требования
- Нужно: Docker

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
codex mcp add adb-mcp-android-emulator-and-device-control-over-adb -- docker run -i --rm ghcr.io/iksnerd/adb-mcp:0.24.3
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "adb-mcp-android-emulator-and-device-control-over-adb": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/iksnerd/adb-mcp:0.24.3"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
gemini mcp add adb-mcp-android-emulator-and-device-control-over-adb docker run -i --rm ghcr.io/iksnerd/adb-mcp:0.24.3
```

## Когда брать
- снять скриншот экрана Android без битых байтов CRLF
- получить точные координаты элементов интерфейса через describe_ui
- передать нажатия и жесты на виртуальное устройство
- запустить сборку или прогон тестов через Gradle
- прочитать системный журнал logcat для разбора падений

## Примеры запросов агенту
- Запусти эмулятор Android и сделай снимок экрана
- Найди кнопку через describe_ui и нажми на неё с помощью tap_on_text
- Собери проект через Gradle и проверь ошибки в logcat

## Похожие
- [mobile-mcp](https://affpapa.org/nevibecode/mcp/mobile-mcp.md) — MCP-сервер · ★ 10025
- [mobilerun](https://affpapa.org/nevibecode/mcp/mobilerun.md) — MCP-сервер · ★ 9833
- [e2e](https://affpapa.org/nevibecode/mcp/e2e.md) — MCP-сервер · ★ 11962
- [XcodeBuildMCP](https://affpapa.org/nevibecode/mcp/xcodebuildmcp.md) — MCP-сервер · ★ 6511
- [ShipSwift](https://affpapa.org/nevibecode/mcp/shipswift.md) — MCP-сервер · ★ 3244
- [agent-device](https://affpapa.org/nevibecode/mcp/agent-device.md) — MCP-сервер · ★ 5158

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md