Skip to main content
Glama

✨ 드로이드마인드 🤖

파이썬 3.13+ 특허 상태 코드 스타일 유형 확인

모델 컨텍스트 프로토콜을 통해 AI로 안드로이드 기기를 제어하세요

DroidMind는 AI 어시스턴트와 안드로이드 기기를 연결하는 강력한 다리 역할을 하며, 자연어를 통해 제어, 디버깅 및 시스템 분석을 지원합니다. DroidMind는 모델 컨텍스트 프로토콜(MCP)을 구현하여 AI 모델이 ADB를 통해 안전하고 체계적인 방식으로 안드로이드 기기와 직접 상호 작용할 수 있도록 지원합니다. DroidMind를 에이전트 코딩 워크플로의 일부로 사용하면 어시스턴트가 루프 내에서 기기를 직접 빌드하고 디버깅할 수 있습니다.

💫 특징

  • 📱 장치 제어 - USB 또는 TCP/IP를 통해 장치에 연결하고, 셸 명령을 실행하고, 재부팅합니다.

  • 📊 시스템 분석 - 장치 속성 검사, 하드웨어 정보 보기, 시스템 로그 분석

  • 🔍 파일 시스템 액세스 - 디렉토리 내용을 탐색하고 장치의 파일을 관리합니다.

  • 📷 시각적 진단 - 분석 및 디버깅을 위해 장치 스크린샷을 캡처합니다.

  • 📦 앱 관리 - 연결된 기기에서 앱 설치, 제거, 시작, 중지 및 데이터 삭제

  • 🔄 다중 장치 지원 - 연결된 여러 장치를 제어하고 전환하세요

  • 👆 UI 자동화 - 탭, 스와이프, 텍스트 입력, 키 누름을 통해 장치와 상호 작용합니다.

  • 🔍 앱 검사 - 앱 매니페스트, 공유 기본 설정 및 앱별 로그 보기

  • 🔒 보안 프레임워크 - 포괄적인 명령 검증으로 장치 보호

  • 💬 MCP 통합 - Claude, Cursor, Cline 등과 원활하게 연결

Related MCP server: MCP Android Agent

🚀 설치

지엑스피1

📋 필수 조건

  • Python 3.13 이상

  • USB 디버깅이 활성화된 Android 기기

  • ADB(Android Debug Bridge)가 설치되고 PATH에 있음

  • UV 패키지 관리자(종속성 관리에 권장)

  • 네트워크 제어를 위해: TCP/IP를 통한 ADB가 활성화된 Android 기기

🔮 빠른 시작

DroidMind 서버를 실행하세요

MCP를 통해 AI 어시스턴트를 연결하기 위해 DroidMind를 서버로 실행하세요.

# Start DroidMind as a network server
droidmind --transport sse

AI 어시스턴트와 함께 사용

  1. SSE 모드에서 DroidMind를 시작하세요:

    droidmind --transport sse
  2. MCP 프로토콜 URI를 사용하여 AI 어시스턴트를 연결합니다.

    sse://localhost:4256/sse
  3. 이제 AI가 자연어로 안드로이드 기기를 제어할 수 있습니다!

🛠️ 사용 가능한 MCP 리소스 및 도구

자원

  • devices://list - 연결된 모든 장치 나열

  • device://{serial}/properties - 자세한 장치 속성을 가져옵니다.

  • logs://{serial}/logcat - 장치에서 최근 로그를 가져옵니다.

  • logs://{serial}/anr - 애플리케이션 응답 없음(ANR) 추적 가져오기

  • logs://{serial}/crashes - 애플리케이션 충돌 로그 가져오기

  • logs://{serial}/battery - 배터리 통계 및 기록을 가져옵니다.

  • logs://{serial}/app/{package} - 애플리케이션별 로그 가져오기

  • fs://{serial}/list/{path} - 장치의 디렉토리 내용을 나열합니다.

  • fs://{serial}/read/{path} - 장치에서 파일 내용을 읽습니다.

  • fs://{serial}/stats/{path} - 자세한 파일/디렉토리 통계를 가져옵니다.

  • app://{serial}/{package}/manifest - AndroidManifest.xml 내용 가져오기

  • app://{serial}/{package}/data - 앱의 데이터 디렉토리에 있는 파일 나열

  • app://{serial}/{package}/shared_prefs - 앱의 공유 기본 설정 가져오기

도구

  • devicelist - 연결된 모든 Android 기기 나열

  • device_properties - 특정 장치의 자세한 속성을 가져옵니다.

  • device_logcat - 장치에서 최근 logcat 출력을 가져옵니다.

  • list_directory - 장치의 디렉토리 내용 나열

  • connect_device - TCP/IP를 통해 장치에 연결

  • disconnect_device - Android 기기에서 연결 해제

  • shell_command - 장치에서 셸 명령을 실행합니다.

  • install_app - 기기에 APK 설치

  • uninstall_app - 기기에서 앱 제거

  • start_app - 기기에서 앱 시작

  • stop_app - 기기에서 앱을 강제로 중지합니다.

  • clear_app_data - 앱 데이터 및 캐시 지우기

  • list_packages - 장치에 설치된 패키지 목록

  • get_app_manifest - 앱의 AndroidManifest.xml 내용을 가져옵니다.

  • get_app_permissions - 앱에서 요청한 권한 가져오기

  • get_app_activities - 앱에 정의된 활동 가져오기

  • get_app_info - 앱에 대한 자세한 정보를 가져옵니다.

  • reboot_device - 장치를 재부팅합니다(일반, 복구 또는 부트로더).

  • screenshot - 기기에서 스크린샷 가져오기

  • capture_bugreport - 장치에서 포괄적인 버그 보고서를 생성합니다.

  • dump_heap - 메모리 분석을 위해 실행 중인 프로세스에서 힙 덤프를 생성합니다.

  • push_file - 장치에 파일 업로드

  • pull_file - 장치에서 파일을 다운로드합니다.

  • delete_file - 장치에서 파일이나 디렉토리를 삭제합니다.

  • create_directory - 장치에 디렉토리를 생성합니다

  • file_exists - 장치에 파일이 있는지 확인합니다.

  • read_file - 장치의 파일 내용을 읽습니다.

  • write_file - 장치의 파일에 텍스트 콘텐츠를 씁니다.

  • file_stats - 파일이나 디렉토리에 대한 자세한 정보를 가져옵니다.

  • tap - 특정 좌표에서 장치 화면을 탭합니다.

  • swipe - 화면의 한 지점에서 다른 지점으로 스와이프 제스처를 수행합니다.

  • input_text - 키보드에서 입력하는 것처럼 장치에 텍스트를 입력합니다.

  • press_key - 하드웨어 또는 소프트웨어 키(예: HOME, BACK, VOLUME)를 누릅니다.

  • start_intent - Android 인텐트를 사용하여 앱 활동 시작

📊 AI Assistant 쿼리 예시

DroidMind에 연결된 AI 비서를 사용하여 다음 쿼리를 시도해 보세요.

  • "연결된 모든 Android 기기를 나열하고 해당 속성을 보여주세요"

  • "192.168.1.100에서 내 휴대폰에 연결하여 배터리 상태를 확인하세요"

  • "Pixel의 스크린샷을 찍어서 현재 화면에 무엇이 있는지 보여주세요"

  • "내 기기의 사용 가능한 저장 공간을 확인하세요"

  • "내 기기의 ANR 추적 및 충돌 로그를 보여주세요"

  • "최근 로그를 보고 오류가 있는지 알려주세요"

  • "내 기기에 이 APK 파일을 설치하고 성공했는지 알려주세요"

  • "내 휴대폰에 설치된 모든 앱 목록을 보여줘"

  • "내 기기를 복구 모드로 재부팅하세요"

  • "내 휴대폰은 어떤 안드로이드 버전을 사용하고 있나요?"

  • "내 기기가 루팅되었는지 확인하고 보안 패치 수준을 알려주세요"

  • "com.android.settings에 대한 매니페스트 파일을 보여주세요"

  • "내 앱의 공유 환경 설정 확인"

  • "좌표 500,1000에 있는 설정 아이콘을 탭하세요"

  • "화면 상단에서 아래로 살짝 밀어 알림 창을 엽니다."

  • "현재 텍스트 필드에 내 비밀번호를 입력하세요"

  • "홈 화면으로 돌아가려면 뒤로가기 버튼을 세 번 누르세요"

  • "com.android.settings 패키지를 시작하여 설정 앱을 엽니다."

🔒 보안 기능

DroidMind에는 AI 도우미가 풍부한 표현력을 발휘할 수 있도록 하는 동시에 기기를 보호하는 포괄적인 보안 프레임워크가 포함되어 있습니다.

  • 명령 검증 : 모든 셸 명령은 안전한 명령 허용 목록에 대해 검증됩니다.

  • 위험 평가 : 명령은 위험 수준(안전, 낮음, 보통, 높음, 중요)별로 분류됩니다.

  • 명령 살균 : 명령 주입 공격을 방지하기 위해 입력이 살균됩니다.

  • 보호된 경로 : 시스템 디렉토리와 중요 경로는 수정으로부터 보호됩니다.

  • 종합 로깅 : 모든 명령은 감사를 위해 위험 수준과 함께 로깅됩니다.

  • 의심스러운 패턴 감지 : 잠재적으로 위험한 패턴이 있는 명령이 차단됩니다.

  • ADB 명령 보안 : 적절한 비동기 검증을 통한 ADB 특정 명령에 대한 특별 처리

보안 시스템은 파괴적인 행위를 방지하는 동시에 일반적인 작업은 허용할 수 있도록 설계되었습니다. 고위험 명령은 실행 전에 사용자에게 경고를 표시하며, 중요한 작업은 명시적인 재정의 없이 완전히 차단됩니다.

💻 개발

DroidMind는 종속성 관리 및 개발 워크플로에 UV를 사용합니다. UV는 빠르고 안정적인 Python 패키지 관리자이자 리졸버입니다.

# Update dependencies
uv sync

# Run tests
pytest

# Run linting
ruff check .

# Run type checking
mypy .

🤝 기여하기

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

  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 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 LICENSE 파일을 참조하세요.


Stefanie Jane이 만들었습니다 🌠

DroidMind가 유용하다면 Monster Ultra Violet을 사주세요 ⚡️

Available Tools

8 tools
android-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:

  1. action="install_app"

    • Requires: apk_path

    • Optional: reinstall, grant_permissions

  2. action="uninstall_app"

    • Requires: package

    • Optional: keep_data

  3. action="start_app"

    • Requires: package

    • Optional: activity 3b. action="start_intent"

    • Requires: package, activity

    • Optional: extras

  4. action="stop_app"

    • Requires: package

  5. action="clear_app_data"

    • Requires: package

  6. action="list_packages"

    • Optional: include_system_apps, include_app_name, include_apk_path, max_packages

  7. action="get_app_manifest"

    • Requires: package

  8. action="get_app_permissions"

    • Requires: package

  9. action="get_app_activities"

    • Requires: package

  10. 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:

  1. action="list_devices"

    • No specific arguments required beyond ctx.

  2. action="connect_device"

    • Requires: ip_address

    • Optional: port

  3. action="disconnect_device"

    • Requires: serial

  4. action="reboot_device"

    • Requires: serial

    • Optional: mode (e.g., "normal", "recovery", "bootloader")

  5. 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:

  1. action="list_directory": Lists contents of a directory.

    • Requires: path (directory path on device).

    • Returns: Formatted string of directory contents.

  2. 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.

  3. 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.

  4. action="delete_file": Deletes a file or directory from the device.

    • Requires: path (path to delete on device).

    • Returns: String message confirming deletion.

  5. action="create_directory": Creates a directory on the device.

    • Requires: path (directory path to create on device).

    • Returns: String message confirming creation.

  6. action="file_exists": Checks if a file or directory exists on the device.

    • Requires: path (path to check on device).

    • Returns: True if exists, False otherwise.

  7. action="read_file": Reads the contents of a file from the device.

    • Requires: device_path (or path) for the file on device.

    • Optional: max_size (defaults to 100KB).

    • Returns: String containing file contents or error message.

  8. action="write_file": Writes text content to a file on the device.

    • Requires: device_path (or path) for the file on device, content (text to write).

    • Returns: String message confirming write.

  9. 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:

  1. action="get_device_logcat"

    • Optional: lines, filter_expr, buffer, format_type, max_size.

  2. action="get_app_logs"

    • Requires: package.

    • Optional: lines.

  3. action="get_anr_logs"

    • No specific arguments beyond serial and ctx.

  4. action="get_crash_logs"

    • No specific arguments beyond serial and ctx.

  5. action="get_battery_stats"

    • No specific arguments beyond serial and ctx.


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

    A3.7/5.0

    Scored across 8 tools

    Disambiguation3/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      60
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      A 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.
      20
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An 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 npm
      3
      MIT