Agent Droid Bridge — MCP-сервер для Claude Code: ADB внутри агента
Подключает агента к Android-устройству или эмулятору через ADB: тапы, свайпы, скриншоты, запуск приложений и shell-команды прямо из чата.
claude mcp add --env ADB_EXECUTION_MODE=<ADB_EXECUTION_MODE> --env ADB_ALLOW_SHELL=<ADB_ALLOW_SHELL> --env ADB_PATH=<ADB_PATH> --env ADB_EXTRA_TOOL_PACKS=<ADB_EXTRA_TOOL_PACKS> --env ADB_DENIED_TOOLS=<ADB_DENIED_TOOLS> --transport stdio agent-droid-bridge -- uvx agent-droid-bridgeЧто делает Agent Droid Bridge
Сервер отдаёт агенту инструменты поверх ADB: снять экран, прочитать UI, вытащить элементы, ввести текст, нажать клавишу, запустить приложение, выполнить команду оболочки. Ответы структурированные и короткие, поэтому длинная сессия автоматизации не забивает контекст XML-дампами. Отдельный пак app_manager добавляет ещё девять инструментов: работа с пакетами, жизненный цикл приложений, извлечение APK, разрешения, интенты. Включается переменной ADB_EXTRA_TOOL_PACKS=app_manager.
Транспорт — stdio, так что клиент подойдёт любой, умеющий MCP. Запуск идёт через uvx agent-droid-bridge, клонировать репозиторий не нужно. На хосте нужны Python 3.11+ и установленный ADB; если adb не в PATH, путь задаётся в ADB_PATH. При одном подключённом устройстве сервер берёт его сам, при нескольких спросит выбор.
По умолчанию стоит режим unrestricted — полный доступ к ADB. Для работы с чужими сборками это многовато: переключите ADB_EXECUTION_MODE на restricted с allowlist или выключите оболочку через ADB_ALLOW_SHELL=false. Ненужные инструменты скрываются в ADB_DENIED_TOOLS, команды разбираются через shlex. Логи сессии пишутся в JSONL, если включить MCP_LOG_ENABLED=true и указать MCP_LOG_DIR.
Какие задачи решает
- прогнать UI-сценарий на реальном устройстве без тестового кода
- снять скриншот и прочитать экран по текстовому запросу
- вытащить APK с устройства на хост
- посмотреть разрешения приложения и отправить интент
- проверить состояние экрана после установки сборки
Примеры запросов агенту
- Подключись к устройству, открой настройки и включи тёмную тему
- Запусти приложение и покажи, что сейчас на экране
- Вытащи APK калькулятора на хост и скажи, где он лежит
Как установить Agent Droid Bridge
Командой платформы
claude mcp add --env ADB_EXECUTION_MODE=<ADB_EXECUTION_MODE> --env ADB_ALLOW_SHELL=<ADB_ALLOW_SHELL> --env ADB_PATH=<ADB_PATH> --env ADB_EXTRA_TOOL_PACKS=<ADB_EXTRA_TOOL_PACKS> --env ADB_DENIED_TOOLS=<ADB_DENIED_TOOLS> --transport stdio agent-droid-bridge -- uvx agent-droid-bridgeВместо <…> подставьте свои значения. Ещё 11 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-droid-bridge <команда>
Командой платформы
codex mcp add agent-droid-bridge --env ADB_EXECUTION_MODE=<ADB_EXECUTION_MODE> --env ADB_ALLOW_SHELL=<ADB_ALLOW_SHELL> --env ADB_PATH=<ADB_PATH> --env ADB_EXTRA_TOOL_PACKS=<ADB_EXTRA_TOOL_PACKS> --env ADB_DENIED_TOOLS=<ADB_DENIED_TOOLS> -- uvx agent-droid-bridgeВместо <…> подставьте свои значения. Ещё 11 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-droid-bridge <команда>
Файл настроек
{
"mcpServers": {
"agent-droid-bridge": {
"command": "uvx",
"args": [
"agent-droid-bridge"
],
"env": {
"ADB_EXECUTION_MODE": "<ADB_EXECUTION_MODE>",
"ADB_ALLOW_SHELL": "<ADB_ALLOW_SHELL>",
"ADB_PATH": "<ADB_PATH>",
"ADB_EXTRA_TOOL_PACKS": "<ADB_EXTRA_TOOL_PACKS>",
"ADB_DENIED_TOOLS": "<ADB_DENIED_TOOLS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 11 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-droid-bridge <команда>
Файл настроек
{
"servers": {
"agent-droid-bridge": {
"type": "stdio",
"command": "uvx",
"args": [
"agent-droid-bridge"
],
"env": {
"ADB_EXECUTION_MODE": "<ADB_EXECUTION_MODE>",
"ADB_ALLOW_SHELL": "<ADB_ALLOW_SHELL>",
"ADB_PATH": "<ADB_PATH>",
"ADB_EXTRA_TOOL_PACKS": "<ADB_EXTRA_TOOL_PACKS>",
"ADB_DENIED_TOOLS": "<ADB_DENIED_TOOLS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 11 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-droid-bridge <команда>
Командой платформы
gemini mcp add -e ADB_EXECUTION_MODE=<ADB_EXECUTION_MODE> -e ADB_ALLOW_SHELL=<ADB_ALLOW_SHELL> -e ADB_PATH=<ADB_PATH> -e ADB_EXTRA_TOOL_PACKS=<ADB_EXTRA_TOOL_PACKS> -e ADB_DENIED_TOOLS=<ADB_DENIED_TOOLS> agent-droid-bridge uvx agent-droid-bridgeВместо <…> подставьте свои значения. Ещё 11 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-droid-bridge <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Agent Droid Bridge
Как установить Agent Droid Bridge в Claude Code?
Добавьте сервер командой claude mcp add agent-droid-bridge -- uvx agent-droid-bridge. Если нужны переменные окружения, используйте вариант с флагами --env и --transport stdio.
Что делает Agent Droid Bridge?
Даёт агенту инструменты ADB: тапы, свайпы, ввод текста, скриншоты, чтение UI и shell-команды на подключённом Android-устройстве или эмуляторе.
Что нужно, чтобы сервер заработал?
Python 3.11+ и ADB на хосте, плюс подключённое устройство или запущенный эмулятор. Если adb не в PATH, пропишите полный путь в ADB_PATH.
