Mcp Android Adb Server

Name: Mcp Android Adb Server
Author: github-hewei

@github-hewei

代码仓库

关于 Mcp Android Adb Server

通过AI大模型操作安卓设备

基本信息

分类

其他

许可证

GPL-3.0

运行时

传输方式

stdio

发布者

github-hewei

提交者

wei he

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-android-adb-server": {
      "name": "mcp-android-adb-server",
      "command": "D:\\www\\golang\\mcp-android-adb-server\\mcp-android-adb-server.exe",
      "env": {
        "DEVICE_ID": "E6EDU20723063683",
        "SCREEN_LOCK_PASSWORD": "123456"
      }
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Mcp Android Adb Server?

Mcp Android Adb Server is an MCP (Model Context Protocol) service for operating Android devices via ADB (Android Debug Bridge). It is designed for developers who need programmatic control over Android devices, including app management, screen control, input simulation, and device information retrieval.

How to use Mcp Android Adb Server?

Clone the repository, build with go build, then configure the server in your MCP client using a JSON object with the command path and required environment variables, including DEVICE_ID. Optional variables enable screen unlocking and visual model support for screenshot descriptions.

Key features of Mcp Android Adb Server

App installation, uninstallation, and management via ADB
Screen locking, unlocking, and status checks
Text input, key press, tap, and gesture simulation
Swipe gestures in four directions
Device information including screen size, DPI, and system info
Screenshot description using optional visual models (e.g., qwen2.5-vl)
Execute arbitrary shell commands on the device

Use cases of Mcp Android Adb Server

Automate app installation and testing on Android devices
Remotely control device screen for unattended operations
Simulate user input for UI testing or accessibility scripts
Retrieve device hardware and software information programmatically

FAQ from Mcp Android Adb Server

What is required to use Mcp Android Adb Server?

You need an Android device with USB debugging enabled, ADB installed on your host, and the device ID (DEVICE_ID) obtained via adb devices. A screen lock password (SCREEN_LOCK_PASSWORD) is optional.

How do I enable the visual model for screenshot descriptions?

Set VISUAL_MODEL_ON to true and provide VISUAL_MODEL_API_KEY, VISUAL_MODEL_BASE_URL, and VISUAL_MODEL_NAME (e.g., qwen/qwen2.5-vl-72b-instruct:free).

What environment variables are supported?

DEVICE_ID (required), SCREEN_LOCK_PASSWORD, VISUAL_MODEL_ON, VISUAL_MODEL_API_KEY, VISUAL_MODEL_BASE_URL, and VISUAL_MODEL_NAME (all optional except DEVICE_ID).