Android Adb Server

🚀 MCP-Android-ADB-Server（注：MCP可能代表某个特定项目或组织的缩写，Android是安卓系统的英文名称，ADB是Android Debug Bridge（安卓调试桥）的缩写，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。
• 视觉模型API密钥：API密钥。
• 视觉模型基础URL：API基础URL。
• 视觉模型名称：模型名称。

功能和工具

应用程序管理

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

屏幕控制

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

输入控制

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

手势控制

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

设备信息

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

其他功能

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