Mcp Android Adb Server

by github-hewei

27 stars
443 downloads
Not rated
GitHub

About

Control Android devices using the Android Debug Bridge (ADB).

Details

Author
github-hewei
GitHub stars
27
Downloads
443
Categories
Developer Tools, Other, Infrastructure

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Mcp Android Adb Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp android adb server": {
            "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"
                }
            }
        }
    }
}

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

Control Android devices using the Android Debug Bridge (ADB).

An MCP service for operating Android devices via ADB.

2025-04-01: Added support for obtaining screen description content using visual models likeqwen2.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 : Required. The ID of the Android device, obtainable via theadb devicescommand.
- SCREEN_LOCK_PASSWORD : Optional. The screen lock password of the device, used to unlock the screen.
- VISUAL_MODEL_ON : Optional. Whether to enable the visual model, defaults to false.
- VISUAL_MODEL_API_KEY : API Key.
- VISUAL_MODEL_BASE_URL : API Base URL.
- VISUAL_MODEL_NAME : Model name.

- install_app : Install an application on the Android device
- uninstall_app : Uninstall an application from the Android device
- terminate_app : Terminate a running application on the Android device
- launch_app : Launch an application on the Android device
- list_app : List all installed applications on the Android device
- is_app_installed : Check if a specific application is installed

- unlock_screen : Unlock the Android device screen
- lock_screen : Lock the Android device screen
- is_screen_locked : Check if the Android device screen is locked
- is_screen_active : Check if the Android device screen is active

- input_text : Input text on the Android device
- input_key : Input key press on the Android device
- tap : Perform a tap operation on the screen at a specified position
- long_tap : Perform a long press operation on the screen at a specified position
- back : Perform a back operation

- swipe_up : Perform a swipe up gesture on the Android device screen
- swipe_down : Perform a swipe down gesture on the Android device screen
- swipe_left : Perform a swipe left gesture on the Android device screen
- swipe_right : Perform a swipe right gesture on the Android device screen

- screen_size : Get the screen size of the Android device
- screen_dpi : Get the screen DPI of the Android device
- screenshot_description : Get the Android device screenshot description
- system_info : Get system information of the Android device

- shell_command : Execute a shell command on the Android device

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

A CLI tool for developers to manage Android devices via ADB.

Drives an Android emulator or a real device over adb: screenshots, UI hierarchy with true device-pixel coordinates, tap and type, app lifecycle, logcat, and Gradle builds and tests.

Interact with Android devices using the Android Debug Bridge (ADB).

Agent Droid Bridge gives AI agents programmatic control over Android devices and emulators via ADB, exposed as an MCP server.

AI 測試大師 — MCP server driving pytest / Jest / Cypress / Go / Maestro. Analyze, generate, run, advise. Web + Mobile (iOS/Android/BlueStacks).

Control Android devices via the Android Debug Bridge (ADB).

Automate Android devices using the Gbox SDK.

Catch App Store rejections before they happen

An agentic toolkit to control, debug, and profile iOS and Android apps.

The deepest Android Debug Bridge MCP server — 147 tools from UI to baseband.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.