Mcp Android Adb Server

Name: Mcp Android Adb Server
Author: github-hewei

@github-hewei

Repository

About Mcp Android Adb Server

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

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "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"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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).