Сервер MCP ADB

Name: ADB MCP Server
Author: srmorete

значок кузнеца

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

Функции

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

Related MCP server: Android ADB MCP Server

Предпосылки

Node.js (рекомендуется версия 16 или выше, протестировано с 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

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

Добавьте конфигурацию сервера 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_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)

ADB MCP Server