技术文档摘要

🚀 mcp-android-adb-server

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

2025-04-01: 增加了使用视觉模型（如qwen2.5-vl）获取屏幕描述内容的支持。

手动安装

# 克隆仓库并构建
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密钥。
• VISUAL_MODEL_BASE_URL : API基础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命令