什么是MCP Android ADB Server?

MCP Android ADB Server是一款基于MCP协议的服务，通过ADB（Android Debug Bridge）连接和控制安卓设备。它可以帮助用户轻松实现屏幕控制、应用管理以及设备信息获取等功能。

如何使用MCP Android ADB Server?

只需几步即可完成安装和配置，随后即可通过简单的命令控制您的安卓设备。

适用场景

适用于需要远程操作安卓设备的场景，例如自动化测试、远程调试或娱乐互动。

主要功能

应用管理包括安装、卸载、启动、终止和列出所有已安装的应用程序。

屏幕控制支持解锁、锁定屏幕，检查屏幕状态，以及执行滑动手势。

输入控制允许在设备上输入文本、模拟按键点击或长按。

手势控制支持向上、向下、向左、向右滑动等常见手势。

设备信息获取屏幕分辨率、DPI、系统信息及屏幕截图描述。

Shell命令执行可在设备上直接执行自定义Shell命令。

视觉模型支持新增功能：利用视觉模型（如Qwen2.5-VL）生成屏幕截图的描述内容。

优势与局限性

优势

功能全面，覆盖多种设备操作需求。

支持视觉模型增强用户体验。

易于集成到现有系统中。

局限性

需要设备具备ADB调试模式开启。

某些高级功能可能对设备性能有一定影响。

如何使用

下载与安装

克隆项目代码并编译生成可执行文件。

配置环境变量

设置必要的环境变量，如设备ID、屏幕密码等。

启动服务

运行编译后的可执行文件。

使用案例

案例1：启动应用程序启动设备上的微信应用程序。

案例2：生成屏幕截图描述获取当前屏幕截图并生成自然语言描述。

常见问题

如何确保设备与服务器正常连接？

为什么无法安装某些应用程序？

🚀 mcp-android-adb-server

一个MCP服务，可借助adb对安卓设备进行操作。该服务于2025年4月1日新增支持，能够使用像qwen2.5-vl这样的视觉模型来获取屏幕描述内容。

🚀 快速开始

本项目是一个MCP服务，用于通过adb操作安卓设备，下面为你介绍其安装、配置等使用步骤。

📦 安装指南

手动安装

# 克隆仓库并构建
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	模型名称。