ADB MCP Server

Сервер MCP ADB

Сервер MCP (Model Context Protocol) для взаимодействия с устройствами Android через ADB. Этот инструмент на основе TypeScript обеспечивает мост между моделями ИИ и функциональностью устройств Android.

Функции

• 📱 Управление устройствами — список подключенных устройств Android и взаимодействие с ними
• 📦 Установка приложения — развертывание APK-файлов на подключенных устройствах
• 📋 Ведение журнала — доступ к журналам устройства через logcat
• 🔄 Передача файлов — передача и извлечение файлов между устройством и хостом
• 📸 Взаимодействие с пользовательским интерфейсом — делайте снимки экрана и анализируйте иерархию пользовательского интерфейса.
• 🔧 Выполнение команд оболочки — запуск пользовательских команд на устройстве

Предпосылки

• Node.js (рекомендуется версия 16 или выше, протестировано с Node.js v16, v18 и v20)
• ADB (Android Debug Bridge) установлен и находится в вашем PATH
• Устройство Android или эмулятор, подключенный через USB или сеть с включенной функцией отладки по USB
• Разрешение на доступ к устройству (принято разрешение на отладку на устройстве)

Установка

Установка через Smithery

Чтобы автоматически установить ADB Android Device Server для Claude Desktop через Smithery :

Ручная установка

Конфигурация

Конфигурация пути ADB

Сервер использует пути ADB по умолчанию. Для пользовательского расположения ADB:

Конфигурация МКП

Добавьте конфигурацию сервера ADB MCP:

Использование

Запуск сервера

ВАЖНО: Перед использованием любых инструментов ADB сервер должен быть запущен.

Запустите сервер с помощью:

Вы должны увидеть:

Держите это окно терминала открытым при использовании инструментов ADB.

Доступные инструменты

Все инструменты доступны со следующим соглашением об именовании:

📱 Управление устройством

• adb_devices - Список подключенных устройств
• adb_shell — выполнение команд оболочки на устройстве

📦 Управление приложениями

• adb_install — установка APK-файла с использованием локального пути к файлу

📋 Ведение журнала

• adb_logcat — просмотр журналов устройства с возможностью фильтрации

🔄 Передача файлов

• adb_pull - Извлечение файлов с устройства
• adb_push — отправка файлов на устройство

🔍 Взаимодействие с пользовательским интерфейсом

• dump_image — сделать снимок экрана текущего экрана
• inspect_ui — получение иерархии пользовательского интерфейса в формате XML (наиболее полезно для взаимодействия с ИИ)

Поиск неисправностей

Если инструменты не работают:

• Проблемы с сервером:
  • Убедитесь, что сервер запущен ( npx adb-mcp )
  • Проверьте вывод сервера на наличие сообщений об ошибках.
  • Попробуйте подробные логи: LOG_LEVEL=3 npx adb-mcp
  • Уничтожить зависшие процессы:
    • ps aux | grep "adb-mcp" | grep -v grep
    • затем kill -9 [PID]
• Подключение устройства:
  • Проверьте соединение с adb_devices
  • Если «не авторизовано», примите разрешение на отладку на устройстве
  • Проверьте USB/сетевые соединения
  • Попробуйте перезапустить ADB: adb kill-server && adb start-server
• Вопросы АБР:
  • Проверьте установку ADB: adb version
• Настройка устройства:
  • Используйте эмулятор (он был создан с его помощью), для реальных устройств попробуйте это:
    • Убедитесь, что отладка по USB включена.
    • Для более новых версий Android включите «Отладку по USB (Настройки безопасности)»
    • Попробуйте другой USB-порт или кабель.
    • или дайте мне знать в вопросе

Совместимость

• Android 8.0 и выше
• Клиенты MCP, включая Claude в Cursor IDE
• Создан на базе macOS, но должен работать на любой POSIX-совместимой системе (Linux и т. д.).
• На Windows не пробовал, но возможно сработает.

Внося вклад

• Вклады приветствуются! Отправьте запрос на извлечение.
• В случае серьезных изменений сначала откройте вопрос для обсуждения.
• Конечно, вы также можете его форкнуть.
• Примечание: этот проект был vibe-coded так что если вы заметите что-то странное... ну, теперь вы знаете 🙂

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .

Благодарности

• Создано с использованием протокола контекста модели (MCP)