# android

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

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

## Что делает

Сервер даёт агенту 76 инструментов для работы с `logcat`, свойствами системы, системными процессами и состоянием пакетов. Внутри нет Appium или uiautomator2. Сервер работает без сторонних фреймворков: бинарник ADB запускается напрямую через дочерние процессы Node.js.

Встроено 5 готовых сценариев промптов для расследования сбоев и поиска утечек памяти, а также сводные вызовы `device-health` и `analyze-app`. Инструменты разделены на 9 категорий. Лишние группы можно отключить через переменные окружения `ANDROID_TOOLS` или `ANDROID_DISABLE`, чтобы не расходовать токены контекста.

Для запуска нужен бинарник ADB в системном `PATH` либо путь в `ADB_PATH`, а также включённая отладка по USB. Любые операции записи и произвольные команды оболочки заблокированы по умолчанию: их нужно разрешать переменными `ANDROID_MCP_ALLOW_WRITE` и `ANDROID_MCP_ALLOW_SHELL`.

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

## Установка

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

**Командой платформы**
```bash
claude mcp add --env ADB_PATH=<ADB_PATH> --env ANDROID_HOME=<ANDROID_HOME> --env ANDROID_SERIAL=<ANDROID_SERIAL> --env ANDROID_TOOLS=<ANDROID_TOOLS> --env ANDROID_DISABLE=<ANDROID_DISABLE> --transport stdio us-all-android -- npx -y @us-all/android-mcp
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

### Codex

**Командой платформы**
```bash
codex mcp add us-all-android --env ADB_PATH=<ADB_PATH> --env ANDROID_HOME=<ANDROID_HOME> --env ANDROID_SERIAL=<ANDROID_SERIAL> --env ANDROID_TOOLS=<ANDROID_TOOLS> --env ANDROID_DISABLE=<ANDROID_DISABLE> -- npx -y @us-all/android-mcp
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "us-all-android": {
            "command": "npx",
            "args": [
                "-y",
                "@us-all/android-mcp"
            ],
            "env": {
                "ADB_PATH": "<ADB_PATH>",
                "ANDROID_HOME": "<ANDROID_HOME>",
                "ANDROID_SERIAL": "<ANDROID_SERIAL>",
                "ANDROID_TOOLS": "<ANDROID_TOOLS>",
                "ANDROID_DISABLE": "<ANDROID_DISABLE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "us-all-android": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@us-all/android-mcp"
            ],
            "env": {
                "ADB_PATH": "<ADB_PATH>",
                "ANDROID_HOME": "<ANDROID_HOME>",
                "ANDROID_SERIAL": "<ANDROID_SERIAL>",
                "ANDROID_TOOLS": "<ANDROID_TOOLS>",
                "ANDROID_DISABLE": "<ANDROID_DISABLE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e ADB_PATH=<ADB_PATH> -e ANDROID_HOME=<ANDROID_HOME> -e ANDROID_SERIAL=<ANDROID_SERIAL> -e ANDROID_TOOLS=<ANDROID_TOOLS> -e ANDROID_DISABLE=<ANDROID_DISABLE> us-all-android npx -y @us-all/android-mcp
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

## Когда брать
- разобрать стек вызовов падения программы по логам logcat
- отследить рост кучи и утечки памяти процесса
- проверить опасные системные разрешения сторонних пакетов
- замерить время холодного старта и запуска активностей

## Примеры запросов агенту
- Найди последний краш пакета com.example.app на подключённом эмуляторе и покажи стек ошибки.
- Собери сводку состояния устройства через device-health: аккумулятор, память и сетевые параметры.
- Проверь, какие опасные разрешения выданы приложению com.example.app.

## Похожие
- [orca-emulator-android](https://affpapa.org/nevibecode/skills/orca-emulator-android.md) — скилл · 5600 установок
- [android-emulator-qa](https://affpapa.org/nevibecode/skills/android-emulator-qa.md) — скилл · 308 установок
- [adb-mcp: Android emulator and device control over adb](https://affpapa.org/nevibecode/mcp/adb-mcp-android-emulator-and-device-control-over-adb.md) — MCP-сервер · ★ 11
- [test-android-apps](https://affpapa.org/nevibecode/plugins/test-android-apps.md) — плагин · ★ 7604
- [limrun-android-emulator](https://affpapa.org/nevibecode/skills/limrun-android-emulator.md) — скилл · 38700 установок
- [Oh My Android](https://affpapa.org/nevibecode/mcp/oh-my-android.md) — MCP-сервер · ★ 69

## Другие версии с тем же именем
- [android · martingeidobler](https://affpapa.org/nevibecode/mcp/android.md) — ★ 68

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