Android Mobile MCP

🚀 Android Mobile MCP

Android Mobile MCP 搭建了模型上下文協議與安卓設備自動化之間的橋樑，使 AI 代理能夠通過 UI 操作、應用管理和屏幕截圖等方式與安卓設備進行交互。

🚀 快速開始

前提條件

1. 通過 USB 或網絡連接安卓設備。
2. 在安卓設備上啟用 USB 調試。
3. 安裝 ADB（安卓調試橋）。

📦 安裝指南

在配置文件中添加以下內容：

{
  "mcpServers": {
    "android-mobile-mcp": {
      "command": "uvx",
      "args": ["android-mobile-mcp"]
    }
  }
}

📚 詳細文檔

工具參考

屏幕分析

• mobile_dump_ui - 將 UI 元素提取為分層 JSON
  • 解析屏幕 XML 以識別可聚焦元素和文本內容。
  • 計算每個交互元素的中心座標。
  • 返回結構化的父子元素關係。
• mobile_take_screenshot - 捕獲當前屏幕狀態
  • 返回 PNG 圖像數據以進行視覺分析。

觸摸交互

• mobile_click - 在特定座標處點擊
  • 根據當前 UI 狀態驗證座標。
  • 需要事先調用 mobile_dump_ui 進行座標驗證。
  • 防止點擊無效或非交互區域。
• mobile_swipe - 執行滑動手勢
  • 在兩個座標點之間執行定向滑動。
  • 可配置滑動持續時間以控制手勢速度。

文本輸入

• mobile_type - 在聚焦字段中輸入文本
  • 將文本發送到當前活動的輸入字段。
  • 可選擇使用回車鍵自動提交。

導航

• mobile_key_press - 按下系統按鈕
  • 支持硬件和虛擬按鍵：返回、主頁、最近任務、回車鍵。

應用管理

• mobile_list_apps - 列出已安裝的應用程序
  • 過濾掉系統應用和不可啟動的軟件包。
  • 僅返回用戶可訪問的應用程序。
• mobile_launch_app - 按軟件包名稱啟動應用程序
  • 在嘗試啟動前驗證軟件包是否存在。