АРХИВИРОВАНО -- Используйте mobile-device-mcp

Я очень удивлен, что этот репозиторий набрал 50 звезд (!), экосистема иногда бывает очень щедрой, спасибо, что поставили звезду!

Я работаю над чем-то более быстрым, масштабируемым и работающим с iOS, взгляните на mobile-device-mcp.

И не забудьте поставить ⭐ :)

ADB MCP Server

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

Related MCP server: Android Mobile MCP

Возможности

• 📱 Управление устройствами - Список подключенных устройств Android и взаимодействие с ними

• 📦 Установка приложений - Развертывание APK-файлов на подключенных устройствах

• 📋 Логирование - Доступ к логам устройства через logcat

• 🔄 Передача файлов - Копирование файлов между устройством и хостом

• 📸 Взаимодействие с UI - Создание скриншотов и анализ иерархии UI

• 🔧 Выполнение команд оболочки - Запуск пользовательских команд на устройстве

Предварительные требования

• Node.js (рекомендуется v16 или выше, протестировано с Node.js v16, v18 и v20)

• Установленный ADB (Android Debug Bridge), добавленный в ваш PATH

• Устройство Android или эмулятор, подключенный через USB или сеть с включенной отладкой по USB

• Разрешение на доступ к устройству (подтвержденная авторизация отладки на устройстве)

Установка

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

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

npx -y @smithery/cli install @srmorete/adb-mcp --client claude

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

# Clone the repository
git clone https://github.com/srmorete/adb-mcp.git
cd adb-mcp

# Install dependencies
npm install

# Build the TypeScript code
npm run build

# Run the server
npx adb-mcp

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

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

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

export ADB_PATH=/path/to/adb
npx adb-mcp

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

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

{
  "mcpServers": {
    "adb": {
      "command": "npx",
      "args": [
        "adb-mcp"
      ]
    }
  }
}

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

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

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

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

npx adb-mcp

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

[INFO] ADB MCP Server connected and ready

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

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

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

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

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

• adb_shell - Выполнение команд оболочки на устройстве

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

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

• adb_package_manager - Выполнение команд диспетчера пакетов (pm) - список пакетов, предоставление/отзыв разрешений, управление приложениями

• adb_activity_manager - Выполнение команд диспетчера действий (am) - запуск действий, широковещательная рассылка намерений, управление поведением приложений

📋 Логирование

• adb_logcat - Просмотр логов устройства с дополнительной фильтрацией

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

• adb_pull - Копирование файлов с устройства

• adb_push - Копирование файлов на устройство

🔍 Взаимодействие с UI

• dump_image - Создание скриншота текущего экрана

• inspect_ui - Получение иерархии UI в формате XML (наиболее полезно для взаимодействия с ИИ)

Устранение неполадок

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

• Проблемы с сервером:

  • Убедитесь, что сервер запущен (npx adb-mcp)

  • Проверьте вывод сервера на наличие сообщений об ошибках

  • Попробуйте подробные логи: LOG_LEVEL=3 npx adb-mcp

  • Завершите зависшие процессы:

    • ps aux | grep "adb-mcp" | grep -v grep

    • затем kill -9 [PID]

• Подключение устройства:

  • Проверьте подключение с помощью adb_devices

  • Если статус "unauthorized", подтвердите авторизацию отладки на устройстве

  • Проверьте USB/сетевые подключения

  • Попробуйте перезапустить ADB: adb kill-server && adb start-server

• Проблемы с ADB:

  • Проверьте установку ADB: adb version

• Настройка устройства:

  • Используйте эмулятор (проект был создан с его использованием), для реальных устройств попробуйте следующее:

    • Убедитесь, что отладка по USB включена

    • Для новых версий Android включите "Отладка по USB (настройки безопасности)"

    • Попробуйте другой USB-порт или кабель

    • или сообщите мне в issue

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

• Android 8.0 и выше

• Клиенты MCP, включая Claude в Cursor IDE

• Был создан на macOS, но должен работать на любой POSIX-совместимой системе (Linux и т.д.).

• Не тестировался на Windows, но возможно будет работать.

Вклад в проект

• Вклад приветствуется! Отправляйте Pull Request.

• Для серьезных изменений сначала откройте issue для обсуждения.

• Вы, конечно, можете сделать форк

• Примечание: этот проект был создан в стиле vibe-coded, так что если заметите что-то странное... ну, теперь вы знаете 🙂

Лицензия

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

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

• Создано с использованием Model Context Protocol (MCP)