🤖 DroidMind 🧠

Управление устройствами Android с помощью ИИ через протокол контекста модели

DroidMind — это мощный мост между помощниками ИИ и устройствами Android, позволяющий осуществлять управление, отладку и системный анализ с помощью естественного языка. Реализуя протокол контекста модели (MCP), DroidMind позволяет моделям ИИ напрямую взаимодействовать с устройствами Android через ADB безопасным и структурированным способом. При использовании в качестве части рабочего процесса агентного кодирования DroidMind может позволить вашему помощнику создавать и отлаживать ваше устройство непосредственно в цикле.

💫 Основные характеристики

DroidMind предоставляет помощникам на основе искусственного интеллекта следующие возможности:

• 📱 Управление устройствами : подключение через USB/TCP-IP, вывод списка устройств, просмотр свойств и перезагрузка.

• 📊 Анализ систем : доступ к журналам (logcat, ANR, сбои, батарея), сбор отчетов об ошибках и дамп кучи.

• 📂 Управление файлами : просмотр, чтение, запись, отправка, извлечение, удаление и управление файлами/каталогами устройства.

• 📦 Управление приложениями : установка, удаление, запуск, остановка, очистка данных и проверка сведений о приложениях (манифест, разрешения, действия).

• 🖼️ Автоматизация пользовательского интерфейса : выполнение касаний, смахиваний, ввода текста и нажатий клавиш.

• 🐚 Выполнение команд оболочки : выполнение команд оболочки ADB с использованием безопасной среды.

• 🔒 Работайте безопасно : воспользуйтесь преимуществами проверки команд, оценки рисков и дезинфекции.

• 💬 Простая интеграция : подключайтесь к любому MCP-совместимому клиенту (Claude, Cursor, Cline и т. д.).

Подробный список возможностей см. в Руководстве пользователя и Справочнике MCP .

Related MCP server: MCP Android Agent

🚀 Начало работы

Быстрый старт для IDE (нулевая установка с uvx )

Для самого быстрого способа интеграции DroidMind с IDE, совместимой с MCP (например, Cursor), вы можете настроить его для запуска DroidMind напрямую из репозитория GitHub с помощью uvx . Этот метод не требует ручного клонирования или предварительной установки DroidMind .

Добавьте следующее в конфигурацию MCP вашей IDE (например, .cursor/mcp.json для Cursor):

{
  "mcpServers": {
    "droidmind": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/hyperb1iss/droidmind",
        "droidmind",
        "--transport",
        "stdio" // The default and preferred mode for most IDE integrations
      ]
    }
  }
}

Ваша IDE будет настроена на запуск DroidMind по требованию. Полные инструкции по этой настройке приведены в кратком руководстве по началу работы .

Предпосылки

• Python 3.13 или выше

• uv (менеджер пакетов Python)

• Устройство Android с включенной отладкой по USB

• ADB (Android Debug Bridge) установлен и находится в PATH вашей системы

Установка

Подробные инструкции по настройке DroidMind, включая быструю интеграцию IDE с uvx (описанную в кратком руководстве), ручную установку из исходного кода или с использованием Docker, см. в нашем подробном руководстве по установке .

Запуск DroidMind

Способ запуска DroidMind зависит от ваших настроек:

• Интеграция с IDE (через uvx ) : Ваша IDE автоматически управляет работой DroidMind, как указано в настройках MCP (например, mcp.json ). См. Краткое руководство по началу работы .

• Ручная установка : После установки из исходного кода вы можете запустить DroidMind напрямую.

  • Stdio (для прямого взаимодействия с терминалом или некоторых настроек IDE):

    droidmind --transport stdio

  • SSE (для веб-интерфейсов или помощников на основе искусственного интеллекта, таких как Claude Desktop):

    droidmind --transport sse

    Обычно это запускает сервер по адресу sse://localhost:4256/sse .

• Docker : команды для запуска DroidMind в контейнере см. в руководстве Docker .

Более подробную информацию о запуске DroidMind в различных средах можно найти в Руководстве по установке .

🐳 Работа с Docker

DroidMind также можно запустить с помощью Docker для создания последовательной контейнеризированной среды. Это особенно полезно для развертывания и изоляции зависимостей.

Подробные инструкции по созданию образа Docker и запуску DroidMind в контейнере с транспортом stdio или SSE , включая примечания по доступу к устройствам ADB, см. в нашем руководстве по Docker .

🔮 Примеры запросов помощника ИИ

С помощью искусственного интеллекта, подключенного к DroidMind, вы можете делать такие запросы, как:

• «Вывести список всех подключенных устройств Android и показать их свойства».

• «Сделай снимок экрана моего Pixel».

• «Установите этот APK на emulator-5554 ».

• «Покажите мне последние журналы сбоев your_device_serial ».

• «Нажмите кнопку «Далее» на текущем экране emulator-5554 ».

Для большего вдохновения ознакомьтесь с примерами запросов и рабочих процессов в руководстве пользователя.

🔒 Безопасность

DroidMind включает в себя инфраструктуру безопасности для защиты ваших устройств:

• Проверка и очистка команд

• Категоризация оценки риска

• Операции по защищенному пути

• Комплексное ведение журнала

Операции с высоким риском помечаются, а критические блокируются по умолчанию. Узнайте больше в нашей главе «Соображения безопасности» .

💻 Развитие

DroidMind использует uv для управления зависимостями и рабочими процессами разработки.

# Install/update dependencies (after cloning and activating .venv)
uv pip install -e .[dev,sse]

# Run tests
pytest

# Run linting
ruff check .

# Run type checking
pyright # Ensure pyright is installed or use ruff's type checking capabilities

🤝 Вклад

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.

1. Создайте форк репозитория.

2. Создайте ветку функций ( git checkout -b feature/amazing-feature ).

3. Настройте среду разработки с помощью uv .

4. Внесите изменения.

5. Выполнение тестов, линтинга и проверки типов.

6. Зафиксируйте свои изменения ( git commit -m 'Add some amazing feature' ).

7. Отправьте изменения в ветку ( git push origin feature/amazing-feature ).

8. Откройте запрос на извлечение.

📝 Лицензия

Данный проект лицензирован по лицензии Apache — подробности смотрите в файле ЛИЦЕНЗИЯ .

Создано Стефани Джейн 🌠

Если DroidMind оказался вам полезен, купите мне Monster Ultra Violet ⚡️