DroidMind

🤖 DroidMind 🧠

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

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

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

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

• 📱 Управление устройствами : подключение через USB/TCP-IP, вывод списка устройств, просмотр свойств и перезагрузка.
• 📊 Анализ систем : доступ к журналам (logcat, ANR, сбои, батарея), сбор отчетов об ошибках и дамп кучи.
• 📂 Управление файлами : просмотр, чтение, запись, отправка, извлечение, удаление и управление файлами/каталогами устройства.
• 📦 Управление приложениями : установка, удаление, запуск, остановка, очистка данных и проверка сведений о приложениях (манифест, разрешения, действия).
• 🖼️ Автоматизация пользовательского интерфейса : выполнение касаний, смахиваний, ввода текста и нажатий клавиш.
• 🐚 Выполнение команд оболочки : выполнение команд оболочки ADB с использованием безопасной среды.
• 🔒 Работайте безопасно : воспользуйтесь преимуществами проверки команд, оценки рисков и дезинфекции.
• 💬 Простая интеграция : подключайтесь к любому MCP-совместимому клиенту (Claude, Cursor, Cline и т. д.).

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

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

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

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

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

Ваша 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 для управления зависимостями и рабочими процессами разработки.

🤝 Вклад

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

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 ⚡️