DroidMind
🤖 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 stdioSSE (для веб-интерфейсов или помощников на основе искусственного интеллекта, таких как 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🤝 Вклад
Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.
Создайте форк репозитория.
Создайте ветку функций (
git checkout -b feature/amazing-feature).Настройте среду разработки с помощью
uv.Внесите изменения.
Выполнение тестов, линтинга и проверки типов.
Зафиксируйте свои изменения (
git commit -m 'Add some amazing feature').Отправьте изменения в ветку (
git push origin feature/amazing-feature).Откройте запрос на извлечение.
📝 Лицензия
Данный проект лицензирован по лицензии Apache — подробности смотрите в файле ЛИЦЕНЗИЯ .
Создано Стефани Джейн 🌠
Если DroidMind оказался вам полезен, купите мне Monster Ultra Violet ⚡️
Available Tools
8 toolsandroid-appA
Perform various application management operations on an Android device.
This single tool consolidates various app-related actions. The 'action' parameter determines the operation.
Args:
serial: Device serial number.
action: The specific app operation to perform.
ctx: MCP Context for logging and interaction.
package (Optional[str]): Package name for the target application. Required by most actions.
apk_path (Optional[str]): Path to the APK file (local to the server). Used by install_app.
reinstall (Optional[bool]): Whether to reinstall if app exists. Used by install_app.
grant_permissions (Optional[bool]): Whether to grant all requested permissions. Used by install_app.
keep_data (Optional[bool]): Whether to keep app data and cache directories. Used by uninstall_app.
activity (Optional[str]): Optional activity name to start. Used by start_app.
extras (Optional[dict[str, str]]): Optional intent extras. Used by start_intent.
include_system_apps (Optional[bool]): Whether to include system apps. Used by list_packages.
include_app_name (Optional[bool]): Whether to include app labels (best-effort). Used by list_packages.
include_apk_path (Optional[bool]): Whether to include APK paths. Used by list_packages.
max_packages (Optional[int]): Max packages to return. Used by list_packages.
Returns: A string message indicating the result or status of the operation.
Available Actions and their specific argument usage:
action="install_app"Requires:
apk_pathOptional:
reinstall,grant_permissions
action="uninstall_app"Requires:
packageOptional:
keep_data
action="start_app"Requires:
packageOptional:
activity3b.action="start_intent"Requires:
package,activityOptional:
extras
action="stop_app"Requires:
package
action="clear_app_data"Requires:
package
action="list_packages"Optional:
include_system_apps,include_app_name,include_apk_path,max_packages
action="get_app_manifest"Requires:
package
action="get_app_permissions"Requires:
package
action="get_app_activities"Requires:
package
action="get_app_info"Requires:
package
Inputs: serial (required), action (required), package, apk_path, +9 more. Returns: result
android-deviceA
Perform various device management operations on Android devices.
This single tool consolidates various device-related actions. The 'action' parameter determines the operation.
Args: action: The specific device operation to perform. ctx: MCP Context for logging and interaction. serial (Optional[str]): Device serial number. Required by most actions except connect/list. ip_address (Optional[str]): IP address for 'connect_device' action. port (Optional[int]): Port for 'connect_device' action (default: 5555). mode (Optional[str]): Reboot mode for 'reboot_device' action (default: "normal").
Returns: A string message indicating the result or status of the operation.
Available Actions and their specific argument usage:
action="list_devices"No specific arguments required beyond
ctx.
action="connect_device"Requires:
ip_addressOptional:
port
action="disconnect_device"Requires:
serial
action="reboot_device"Requires:
serialOptional:
mode(e.g., "normal", "recovery", "bootloader")
action="device_properties"Requires:
serial
Inputs: action (required), serial, ip_address, port, +1 more. Returns: result
android-diagA
Perform diagnostic operations like capturing bug reports or heap dumps.
Args: ctx: MCP Context. serial: Device serial number. action: The diagnostic action to perform. output_path: Optional. Path to save the output file. For bugreport: host path for adb to write the .zip. If empty, a temp file is used & summarized. For dump_heap: local path to save the .hprof. If empty, a temp file is used. include_screenshots: For CAPTURE_BUGREPORT. Default True. package_or_pid: For DUMP_HEAP. App package name or process ID. native: For DUMP_HEAP. True for native (C/C++) heap, False for Java. Default False. timeout_seconds: Max time for the operation. If 0, action-specific defaults are used (bugreport: 300s, dump_heap: 120s).
Returns: A string message indicating the result or path to the output.
Inputs: serial (required), action (required), output_path, include_screenshots, +3 more. Returns: result
android-fileA
Perform file and directory operations on an Android device.
This single tool consolidates various file system actions. The 'action' parameter determines the operation.
Args: serial: Device serial number. action: The specific file operation to perform. See available actions below. ctx: MCP Context for logging and interaction. path (Optional[str]): General path argument on the device. Used by: list_directory, delete_file, create_directory, file_exists, file_stats. Can also be used by read_file and write_file as an alternative to 'device_path'. local_path (Optional[str]): Path on the DroidMind server machine. Used by: push_file (source), pull_file (destination). device_path (Optional[str]): Path on the Android device. Used by: push_file (destination), pull_file (source), read_file (source), write_file (destination). If 'path' is also provided for read/write, 'device_path' takes precedence. content (Optional[str]): Text content to write. Used by: write_file. max_size (Optional[int]): Maximum file size in bytes for read_file (default: 100KB). Used by: read_file.
Returns: Union[str, bool]: A string message indicating the result or status for most actions. Returns a boolean for the 'file_exists' action.
Available Actions and their specific argument usage:
action="list_directory": Lists contents of a directory.Requires:
path(directory path on device).Returns: Formatted string of directory contents.
action="push_file": Uploads a file from the local server to the device.Requires:
local_path(source on server),device_path(destination on device).Returns: String message confirming upload.
action="pull_file": Downloads a file from the device to the local server.Requires:
device_path(source on device),local_path(destination on server).Returns: String message confirming download.
action="delete_file": Deletes a file or directory from the device.Requires:
path(path to delete on device).Returns: String message confirming deletion.
action="create_directory": Creates a directory on the device.Requires:
path(directory path to create on device).Returns: String message confirming creation.
action="file_exists": Checks if a file or directory exists on the device.Requires:
path(path to check on device).Returns:
Trueif exists,Falseotherwise.
action="read_file": Reads the contents of a file from the device.Requires:
device_path(orpath) for the file on device.Optional:
max_size(defaults to 100KB).Returns: String containing file contents or error message.
action="write_file": Writes text content to a file on the device.Requires:
device_path(orpath) for the file on device,content(text to write).Returns: String message confirming write.
action="file_stats": Gets detailed statistics for a file or directory.Requires:
path(path on device).Returns: Markdown-formatted string of file/directory statistics.
Inputs: serial (required), action (required), path, local_path, +3 more. Returns: result
android-logA
Perform various log retrieval operations on an Android device.
This single tool consolidates various log-related actions. The 'action' parameter determines the operation.
Args:
serial: Device serial number.
action: The specific log operation to perform.
ctx: MCP Context for logging and interaction.
package (Optional[str]): Package name for get_app_logs action.
lines (int): Number of lines to fetch for logcat actions (default: 1000).
filter_expr (Optional[str]): Logcat filter expression for get_device_logcat.
buffer (Optional[str]): Logcat buffer for get_device_logcat (default: "main").
format_type (Optional[str]): Logcat output format for get_device_logcat (default: "threadtime").
max_size (Optional[int]): Max output size for get_device_logcat (default: 100KB).
Returns: A string message containing the requested logs or status.
Available Actions and their specific argument usage:
action="get_device_logcat"Optional:
lines,filter_expr,buffer,format_type,max_size.
action="get_app_logs"Requires:
package.Optional:
lines.
action="get_anr_logs"No specific arguments beyond
serialandctx.
action="get_crash_logs"No specific arguments beyond
serialandctx.
action="get_battery_stats"No specific arguments beyond
serialandctx.
Inputs: serial (required), action (required), package, lines, +4 more. Returns: result
android-screenshotA
Get a screenshot from a device.
Args: serial: Device serial number ctx: MCP context quality: JPEG quality (1-100, lower means smaller file size)
Returns: The device screenshot as an image
Inputs: serial (required), quality.
android-shellA
Run a shell command on the device.
Args: serial: Device serial number command: Shell command to run max_lines: Maximum lines of output to return (default: 1000) Use positive numbers for first N lines, negative for last N lines Set to None for unlimited (not recommended for large outputs) max_size: Maximum output size in characters (default: 100000) Limits total response size regardless of line count
Returns: Command output
Inputs: serial (required), command (required), max_lines, max_size. Returns: result
android-uiB
Perform various UI interaction operations on an Android device.
Args: ctx: MCP Context. serial: Device serial number. action: The UI action to perform. x: X coordinate (for tap). y: Y coordinate (for tap). start_x: Starting X coordinate (for swipe). start_y: Starting Y coordinate (for swipe). end_x: Ending X coordinate (for swipe). end_y: Ending Y coordinate (for swipe). duration_ms: Duration of the swipe in milliseconds (default: 300). text: Text to input (for input_text). keycode: Android keycode to press (for press_key). package: Package name (for start_intent). activity: Activity name (for start_intent). extras: Optional intent extras (for start_intent).
Returns: A string message indicating the result of the operation.
Inputs: serial (required), action (required), x, y, +10 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
The top-level tools are clearly categorized, but the internal actions within each mega-tool can overlap (e.g., start_intent appears in both android-app and android-ui), causing potential ambiguity for an agent. Additionally, the bundling of many operations under one tool name makes it less obvious which tool handles a specific action.
All tool names follow a consistent 'android-<category>' pattern, and internal actions use a uniform snake_case style. The naming is predictable and readable across the entire server.
With 8 tools, the count is reasonable for an Android device management server. However, the bundling of many actions into each tool makes the surface feel slightly under-tooled, though still within the effective range.
The tool set covers major areas: app management, device control, diagnostics, file operations, logs, screenshots, shell, and UI. Some gaps exist (e.g., network or settings management), but the core workflows for common Android tasks are well addressed.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
Melaya is a remote MCP server. It gives an assistant hands on your own Android phone and browser: it reads the screen through the accessibility tree, then taps, types and navigates inside the apps and sites you allow-list, with no per-app API. It also builds, schedules and runs agent pipelines across 6k+ connected tools. OAuth 2.1, nothing to install.
MCP server for building and testing AI agents with multi-model experimentation and insights.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceA Model Context Protocol server that enables AI assistants to interact with Android devices through ADB, allowing for automated device management, app installation, file transfers, and screenshot capture.356 npm38ISC
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables AI agents to control and automate Android devices through natural language, supporting actions like app management, UI interactions, and device monitoring.60MIT
- AlicenseAqualityCmaintenanceA MCP server that enables AI assistants to control Android devices via ADB, supporting device info, screen control, input simulation, app management, shell execution, file transfer, and UI parsing.20MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that wraps Android ADB functionality into AI assistant tools, enabling device management, shell execution, file operations, app management, media capture, and log analysis via natural language.23 npm3MIT