# android

Сервер управляет Android-устройствами и эмуляторами через ADB: агент может изучать экран, нажимать элементы и читать логи. Пригодится для проверки приложения без изменений в его коде.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 68
- Автор: martingeidobler
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/martingeidobler/android-mcp-server
- Обновлён: 2026-03-18
- HTML: https://affpapa.org/nevibecode/mcp/android

## Что делает

Сервер даёт агенту инструменты для работы с устройством: сделать скриншот, прочитать дерево интерфейса, нажать элемент по тексту или `resource-id`, ввести текст и выполнить жест. Также доступны установка APK, запуск приложений и чтение `logcat` с фильтрами по пакету, уровню или времени. Есть команды для списка устройств и запуска эмулятора.

Для подключения нужны Node.js 18+, Android SDK с `platform-tools` и ADB, а также запущенный эмулятор или подключённое устройство. Сервер автоматически ищет SDK в `~/Library/Android/sdk` на macOS или использует `ANDROID_HOME`. Если SDK расположен в другом месте, задайте `ANDROID_HOME` в конфигурации MCP: без доступного ADB команды управления Android не сработают.

В Claude Code сервер добавляется командой `claude mcp add`. Поддерживается выбор устройства по ID, а `tap_and_wait` объединяет нажатие, ожидание обновления интерфейса и чтение дерева UI в одном вызове. Приложение менять не требуется: взаимодействие идёт через ADB.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `ANDROID_HOME` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env ANDROID_HOME=<ANDROID_HOME> --transport stdio android -- npx -y android-mcp-server
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add android --env ANDROID_HOME=<ANDROID_HOME> -- npx -y android-mcp-server
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "android": {
            "command": "npx",
            "args": [
                "-y",
                "android-mcp-server"
            ],
            "env": {
                "ANDROID_HOME": "<ANDROID_HOME>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "android": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "android-mcp-server"
            ],
            "env": {
                "ANDROID_HOME": "<ANDROID_HOME>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e ANDROID_HOME=<ANDROID_HOME> android npx -y android-mcp-server
```
Вместо <…> подставьте свои значения

## Когда брать
- проверить, какие элементы отображаются на экране
- нажать кнопку по тексту или `resource-id`
- ввести текст и пройти экранные шаги
- снять скриншот и изучить `logcat`
- запустить эмулятор и проверить приложение

## Примеры запросов агенту
- Посмотри, какие элементы сейчас есть на экране Android.
- Нажми кнопку «Войти» и проверь, как изменился интерфейс.
- Сними скриншот приложения и найди ошибки в `logcat`.

## Похожие
- [mobile-mcp](https://affpapa.org/nevibecode/mcp/mobile-mcp.md) — MCP-сервер · ★ 9946
- [mobilerun](https://affpapa.org/nevibecode/mcp/mobilerun.md) — MCP-сервер · ★ 9751
- [e2e](https://affpapa.org/nevibecode/mcp/e2e.md) — MCP-сервер · ★ 11912
- [XcodeBuildMCP](https://affpapa.org/nevibecode/mcp/xcodebuildmcp.md) — MCP-сервер · ★ 6505
- [ShipSwift](https://affpapa.org/nevibecode/mcp/shipswift.md) — MCP-сервер · ★ 3244
- [agent-device](https://affpapa.org/nevibecode/mcp/agent-device.md) — MCP-сервер · ★ 5149

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