Mcp Android Adb Server

🚀 mcp-android-adb-server

一个通过 ADB 操作 Android 设备的 MCP 服务。

2025-04-01：新增支持使用 qwen2.5-vl 等视觉模型获取屏幕描述内容。

手动安装

# clone the repo and build
git clone https://github.com/github-hewei/mcp-android-adb-server.git
cd mcp-android-adb-server
go build

配置

{
  "mcpServers": {
    "mcp-android-adb-server": {
      "command": "D:\\www\\golang\\mcp-android-adb-server\\mcp-android-adb-server.exe",
      "env": {
        "DEVICE_ID": "xxxxx",
        "SCREEN_LOCK_PASSWORD": "123456",
        "VISUAL_MODEL_ON": "true",
        "VISUAL_MODEL_API_KEY": "sk-or-xxxxxxxxxxxxxxxxxxx",
        "VISUAL_MODEL_BASE_URL": "https://openrouter.ai/api/v1/",
        "VISUAL_MODEL_NAME": "qwen/qwen2.5-vl-72b-instruct:free"
      }
    }
  }
}

环境变量

• DEVICE_ID ：必填。Android 设备的 ID，可通过 adb devices 命令获取。
• SCREEN_LOCK_PASSWORD ：可选。设备的锁屏密码，用于解锁屏幕。
• VISUAL_MODEL_ON ：可选。是否启用视觉模型，默认为 false。
• VISUAL_MODEL_API_KEY ：API Key。
• VISUAL_MODEL_BASE_URL ：API Base URL。
• VISUAL_MODEL_NAME ：模型名称。

功能与工具

应用管理

• install_app ：在 Android 设备上安装应用
• uninstall_app ：从 Android 设备上卸载应用
• terminate_app ：终止 Android 设备上正在运行的应用
• launch_app ：在 Android 设备上启动应用
• list_app ：列出 Android 设备上所有已安装的应用
• is_app_installed ：检查是否已安装指定应用

屏幕控制

• unlock_screen ：解锁 Android 设备屏幕
• lock_screen ：锁定 Android 设备屏幕
• is_screen_locked ：检查 Android 设备屏幕是否已锁定
• is_screen_active ：检查 Android 设备屏幕是否处于活动状态

输入控制

• input_text ：在 Android 设备上输入文本
• input_key ：在 Android 设备上输入按键
• tap ：在屏幕指定位置执行点击操作
• long_tap ：在屏幕指定位置执行长按操作
• back ：执行返回操作

手势控制

• swipe_up ：在 Android 设备屏幕上执行上滑手势
• swipe_down ：在 Android 设备屏幕上执行下滑手势
• swipe_left ：在 Android 设备屏幕上执行左滑手势
• swipe_right ：在 Android 设备屏幕上执行右滑手势

设备信息

• screen_size ：获取 Android 设备的屏幕尺寸
• screen_dpi ：获取 Android 设备的屏幕 DPI
• screenshot_description ：获取 Android 设备截图描述
• system_info ：获取 Android 设备的系统信息

其他功能

• shell_command ：在 Android 设备上执行 shell 命令