金大哥 - mcp-android-adb-server MCP 详情

article

README

🚀 mcp-android-adb-server

一个MCP服务，可借助adb对安卓设备进行操作。该服务能让你方便地管理安卓设备上的应用、控制屏幕、输入内容等。在2025年4月1日，增加了使用视觉模型（如qwen2.5-vl）获取屏幕描述内容的功能。

🚀 快速开始

本部分将引导你完成mcp-android-adb-server的安装和配置。

📦 安装指南

手动安装

# 克隆仓库并构建
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 BaseURL。 | | 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 命令

mcp-android-adb-server