hyperb1iss/droidmind

Выполняет различные операции управления приложениями на Android-устройстве. Этот единый инструмент объединяет различные действия с приложениями. Параметр 'action' определяет выполняемую операцию. Аргументы: serial: Серийный номер устройства. action: Конкретная операция с приложением. ctx: MCP-контекст для логирования и взаимодействия. package (Optional[str]): Имя пакета целевого приложения. Требуется большинством действий. apk_path (Optional[str]): Путь к APK-файлу (локальный для сервера). Используется в install_app. reinstall (Optional[bool]): Переустанавливать ли приложение, если оно существует. Используется в install_app. grant_permissions (Optional[bool]): Предоставлять ли все запрашиваемые разрешения. Используется в install_app. keep_data (Optional[bool]): Сохранять ли данные приложения и каталоги кэша. Используется в uninstall_app. activity (Optional[str]): Необязательное имя активности для запуска. Используется в start_app. extras (Optional[dict[str, str]]): Необязательные extras для intent. Используется в start_intent. include_system_apps (Optional[bool]): Включать ли системные приложения. Используется в list_packages. include_app_name (Optional[bool]): Включать ли названия приложений (по мере возможностей). Используется в list_packages. include_apk_path (Optional[bool]): Включать ли пути к APK. Используется в list_packages. max_packages (Optional[int]): Максимальное количество пакетов для возврата. Используется в list_packages. Возвращает: Строковое сообщение с результатом или статусом операции. --- Доступные действия и использование их аргументов: 1. action="install_app" - Требуется: apk_path - Необязательно: reinstall, grant_permissions 2. action="uninstall_app" - Требуется: package - Необязательно: keep_data 3. action="start_app" - Требуется: package - Необязательно: activity 3b. action="start_intent" - Требуется: package, activity - Необязательно: extras 4. action="stop_app" - Требуется: package 5. action="clear_app_data" - Требуется: package 6. …

Выполняет различные операции управления Android-устройствами. Этот единый инструмент объединяет различные действия, связанные с устройствами. Параметр 'action' определяет операцию. Аргументы: action: Конкретная операция с устройством, которую нужно выполнить. ctx: MCP-контекст для логирования и взаимодействия. serial (Optional[str]): Серийный номер устройства. Требуется для большинства действий, кроме connect/list. ip_address (Optional[str]): IP-адрес для действия 'connect_device'. port (Optional[int]): Порт для действия 'connect_device' (по умолчанию: 5555). mode (Optional[str]): Режим перезагрузки для действия 'reboot_device' (по умолчанию: "normal"). Возвращает: Строковое сообщение, указывающее на результат или статус операции. --- Доступные действия и особенности использования их аргументов: 1. action="list_devices" - Кроме ctx, никаких дополнительных аргументов не требуется. 2. action="connect_device" - Требуется: ip_address - Необязательно: port 3. action="disconnect_device" - Требуется: serial 4. action="reboot_device" - Требуется: serial - Необязательно: mode (например, "normal", "recovery", "bootloader") 5. action="device_properties" - Требуется: serial ---

Выполняет диагностические операции, например, собирает отчёты об ошибках или снимает дампы кучи. Аргументы: ctx: MCP Context. serial: Серийный номер устройства. action: Выполняемое диагностическое действие. output_path: Необязательный. Путь для сохранения выходного файла. Для bugreport: путь на хосте, куда adb запишет .zip. Если пусто, используется временный файл, и в результат включается его сводка. Для dump_heap: локальный путь для сохранения .hprof. Если пусто, используется временный файл. include_screenshots: Для CAPTURE_BUGREPORT. По умолчанию True. package_or_pid: Для DUMP_HEAP. Имя пакета приложения или идентификатор процесса. native: Для DUMP_HEAP. True для нативной (C/C++) кучи, False для Java. По умолчанию False. timeout_seconds: Максимальное время операции. Если 0, используются значения по умолчанию для конкретного действия (bugreport: 300s, dump_heap: 120s). Возвращает: Строковое сообщение с результатом или путём к выходному файлу.

Выполняет операции с файлами и директориями на устройстве Android. Этот единый инструмент объединяет различные действия с файловой системой. Параметр 'action' определяет операцию. Аргументы: serial: Серийный номер устройства. action: Конкретная операция с файлами. См. доступные действия ниже. ctx: Контекст MCP для логирования и взаимодействия. path (Optional[str]): Общий аргумент пути на устройстве. Используется: list_directory, delete_file, create_directory, file_exists, file_stats. Также используется в read_file и write_file как альтернатива 'device_path'. local_path (Optional[str]): Путь на сервере DroidMind. Используется: push_file (источник), pull_file (назначение). device_path (Optional[str]): Путь на устройстве Android. Используется: push_file (назначение), pull_file (источник), read_file (источник), write_file (назначение). Если для чтения/записи также указан 'path', 'device_path' имеет приоритет. content (Optional[str]): Текстовое содержимое для записи. Используется: write_file. max_size (Optional[int]): Максимальный размер файла в байтах для read_file (по умолчанию: 100KB). Используется: read_file. Возвращает: Union[str, bool]: Строковое сообщение с результатом или статусом для большинства действий. Возвращает boolean для действия 'file_exists'. --- Доступные действия и их конкретное использование аргументов: 1. action="list_directory": Выводит содержимое директории. - Требуется: path (путь к директории на устройстве). - Возвращает: Отформатированную строку с содержимым директории. 2. action="push_file": Загружает файл с локального сервера на устройство. - Требуется: local_path (источник на сервере), device_path (назначение на устройстве). - Возвращает: Строковое сообщение, подтверждающее загрузку. 3. action="pull_file": Скачивает файл с устройства на локальный сервер. - Требуется: device_path (источник на устройстве), local_path (назначение на сервере). - Возвращает: Строковое сообщение, подтверждающее скачивание. 4. action="delete_file": Удаляет файл. - Требуется: path (путь к файлу на устройстве). - Возвращает: Строковое сообщение, подтверждающее удаление. 5. action="create_directory": Создаёт директорию. - Требуется: path (путь к директории на устройстве). - Возвращает: Строковое сообщение, подтверждающее создание. 6. action="file_exists": Проверяет, существует ли файл или директория. - Требуется: path (путь к файлу или директории на устройстве). - Возвращает: Логическое значение (True, если существует, False в противном случае). 7. action="file_stats": Получает статистику файла или директории. - Требуется: path (путь к файлу или директории на устройстве). - Возвращает: Отформатированную строку с размером файла и временем изменения. 8. action="read_file": Читает содержимое файла. - Требуется: path или device_path (путь к файлу на устройстве). - Возвращает: Строковое содержимое файла. 9. action="write_file": Записывает содержимое в файл. - Требуется: device_path (назначение на устройстве), content (текст для записи). - Возвращает: Строковое сообщение, подтверждающее запись.

Выполняет различные операции получения логов на устройстве Android. Этот единый инструмент объединяет различные действия, связанные с логами. Параметр 'action' определяет операцию. Аргументы: serial: Серийный номер устройства. action: Конкретная операция с логами, которую нужно выполнить. ctx: MCP-контекст для логирования и взаимодействия. package (Optional[str]): Имя пакета для действия get_app_logs. lines (int): Количество строк для получения для действий logcat (по умолчанию: 1000). filter_expr (Optional[str]): Выражение фильтра logcat для get_device_logcat. buffer (Optional[str]): Буфер logcat для get_device_logcat (по умолчанию: "main"). format_type (Optional[str]): Формат вывода logcat для get_device_logcat (по умолчанию: "threadtime"). max_size (Optional[int]): Максимальный размер вывода для get_device_logcat (по умолчанию: 100 КБ). Возвращает: Строковое сообщение, содержащее запрошенные логи или статус. --- Доступные действия и особенности использования их аргументов: 1. action="get_device_logcat" - Необязательные: lines, filter_expr, buffer, format_type, max_size. 2. action="get_app_logs" - Требуется: package. - Необязательные: lines. 3. action="get_anr_logs" - Не требует дополнительных аргументов, кроме serial и ctx. 4. action="get_crash_logs" - Не требует дополнительных аргументов, кроме serial и ctx. 5. action="get_battery_stats" - Не требует дополнительных аргументов, кроме serial и ctx. ---

Получает снимок экрана с устройства. Аргументы: serial: Серийный номер устройства ctx: Контекст MCP quality: Качество JPEG (1-100, меньше значение - меньше размер файла) Возвращает: Снимок экрана устройства в виде изображения

Выполняет shell-команду на устройстве. Аргументы: serial: серийный номер устройства command: shell-команда для выполнения max_lines: максимальное количество строк вывода (по умолчанию: 1000) Используйте положительные числа для первых N строк, отрицательные для последних N строк Установите None для неограниченного вывода (не рекомендуется для больших объёмов) max_size: максимальный размер вывода в символах (по умолчанию: 100000) Ограничивает общий размер ответа независимо от количества строк Возвращает: Вывод команды

Выполняет различные операции взаимодействия с пользовательским интерфейсом на устройстве Android. Аргументы: ctx: MCP Context. serial: Серийный номер устройства. action: Действие UI для выполнения. x: Координата X (для нажатия). y: Координата Y (для нажатия). start_x: Начальная координата X (для смахивания). start_y: Начальная координата Y (для смахивания). end_x: Конечная координата X (для смахивания). end_y: Конечная координата Y (для смахивания). duration_ms: Длительность смахивания в миллисекундах (по умолчанию: 300). text: Текст для ввода (для input_text). keycode: Код клавиши Android для нажатия (для press_key). package: Имя пакета (для start_intent). activity: Имя активности (для start_intent). extras: Необязательные дополнительные данные intent (для start_intent). Возвращает: Строковое сообщение, указывающее на результат операции.