AI导哈

Android设备ADB操作服务

通过ADB操作Android设备的服务，支持应用管理、屏幕控制、输入控制、手势控制及设备信息获取等功能。

  • by github-hewei
  • Go
  • 本地部署
  • 26 星标
  • 更新于
在 GitHub 查看 github-hewei/mcp-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命令

相关 MCP