Skip to main content
Glama
Sign In
Android UI Agent MCP Server

Android UI Agent MCP Server

by physics91
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Android UI Agent MCP Server

uiautomator2 기반 Android UI 자동화를 MCP 도구로 제공합니다.

Quickstart

cd /home/physics91/dev/android-tester
pip install -e .
adb devices
python src/server.py

MCP 클라이언트 설정 예시 (Claude Code):

{
  "mcpServers": {
    "android-ui-agent": {
      "command": "python",
      "args": ["/home/physics91/dev/android-tester/src/server.py"]
    }
  }
}

기본 사용 흐름:

  1. device_list로 디바이스 확인

  2. device_snapshot으로 UI 스냅샷/refs 획득

  3. device_tap, device_type 등으로 상호작용

Related MCP server: phone-control

MCP 툴 목록

  • Device: device_list(연결 목록), device_select(기본 지정), device_info(정보), device_unlock(잠금 해제)

  • Snapshot & Find: device_snapshot(UI 스냅샷+refs), screenshot(base64 PNG), find_element(조건 검색)

  • Interaction: device_tap, device_double_tap, device_long_press, device_type, device_swipe, clear_text

  • Navigation: app_start, app_stop, app_current, go_back, go_home, press_key, open_notification, open_quick_settings, set_orientation

  • Wait: wait_seconds, wait_for_element, wait_for_text, wait_for_activity, wait_for_element_gone

  • Watchers: watcher_add, watcher_remove, watcher_list, watcher_start, watcher_stop, watcher_trigger_once

  • Recording: start_gesture_recording, add_gesture_event, stop_gesture_recording, play_gesture_recording, list_gesture_recordings, export_gesture_recording, import_gesture_recording, delete_gesture_recording

  • Performance: get_performance_metrics, start_performance_monitor, stop_performance_monitor

의존성

  • mcp>=1.0.0 - MCP 서버 프레임워크

  • uiautomator2>=3.4.0 - Android UI 자동화

  • Pillow>=10.0.0 - 이미지 처리

테스트

# Android 디바이스 연결 필요
pytest tests/test_server.py -v

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Resources

    Related MCP Connectors

    Related MCP Servers

    • multi_uiautomator2

      Starlordzz
      F
      license
      A
      quality
      C
      maintenance
      Provides an Android UI automation service with an MCP server, enabling natural language control of Android devices, including clicking, typing, swiping, screenshots, and AI-driven understanding and debugging.
      24
      1
      -

    • phone-control

      sheear
      A
      license
      Not graded
      quality
      B
      maintenance
      Enables controlling an Android device from an MCP client via ADB, including wireless debugging discovery, UI-tree inspection, and performing taps, swipes, typing, app actions, and shell commands without relying on screen coordinates.
      8 npm
      MIT

    • phone

      Aelindra
      A
      license
      C
      quality
      B
      maintenance
      Exposes Android device automation tools to MCP clients, letting AI agents inspect UI trees, interact with elements, launch/stop apps, run shell commands, transfer files, and manage events/tasks over adb/uiautomator2 without installing anything on the device.
      60
      MIT

    • phone-mcp

      Rynque
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables Android device control over ADB through MCP tools that mirror CLI subcommands, including taps, swipes, text input, app launch/stop, screenshots, UI inspection, and running action sequences. Coordinates from screenshots are converted to screen coordinates automatically.
      MIT