ADB-MCP: Android Automated Control MCP Server for Device/App Management

Adb MCP

An MCP server that provides ADB functionality for automated control of Android devices, including functions such as device management, screen operations, app management, file operations, and shell commands.

Developer tools Operating system automation #Android Debugging #Device Control #Automation Tools .TypeScript

rating : 2 points

downloads : 9.0K

update time : 2025-07-31

Open Site

What is the ADB MCP Server?

The ADB MCP server is a middleware service that encapsulates the debugging functions (ADB) of Android devices into standardized MCP protocol interfaces, enabling developers to control Android devices through simple API calls without directly dealing with complex ADB commands.

How to use the ADB MCP Server?

Before use, ensure that the Android device is connected and authorized for debugging. Then, start the MCP server to call various device control functions through the standard interface.

Applicable Scenarios

Suitable for scenarios such as Android device automated testing, batch device management, remote device control, and UI automation. Particularly suitable for developers and testers who need to manage multiple Android devices simultaneously.

Main Features

Device Management

Basic device management functions such as viewing connection status, getting device information, and setting the default device.

Screen Operations

Support screen interaction operations such as taking screenshots, clicking, swiping, and text input.

App Management

Complete application lifecycle management including app installation, uninstallation, startup, stop, and list viewing.

File Operations

File management functions such as file transfer between the device and the computer and directory viewing.

Shell Commands

Execute device shell commands, get system information, battery status, and other underlying operations.

Advantages

Standardized interface: Provides a unified access method through the MCP protocol

Comprehensive functions: Covers most commonly used ADB functions

Safe and controllable: Built - in dangerous command filtering and input validation

Cross - platform: Implemented based on Node.js and supports multiple platforms

Limitations

Depends on the ADB environment: Requires pre - installation and configuration of ADB

Performance limitation: Not suitable for high - frequency real - time control scenarios

Device compatibility: Some functions may be limited due to device manufacturer customization

How to Use

Environment Preparation

Ensure that the Node.js environment and ADB tools are installed, and configure the PATH environment variable.

Install Dependencies

Install project dependencies after cloning the repository.

Build the Project

Compile the TypeScript source code.

Connect the Device

Connect the Android device via USB and enable USB debugging mode.

Start the Server

Run the start command to start the service.

Usage Examples

Batch Screenshot Test

Perform screenshot operations on multiple devices simultaneously for UI consistency check.

App Installation Verification

Automatically test the app installation process.

Frequently Asked Questions

What if the device is not recognized after connection?

The command execution returns a permission error?

How to control multiple devices simultaneously?

Related Resources

ADB Official Documentation

Official usage guide for Android Debug Bridge

MCP Protocol Specification

Technical specification document for the Model Context Protocol

Project Code Repository

Open - source code repository for the ADB MCP server

🚀 ADB MCP

A Model Context Protocol (MCP) server that provides Android Debug Bridge (ADB) functionality for automating Android devices.

🚀 Quick Start

This ADB MCP server offers a range of features to automate Android devices. Follow the installation steps below to get started.

✨ Features

Device Management

List connected devices
Get device information
Set default device for operations
Check device connection status

Screen Operations

Take screenshots
Click at coordinates
Swipe gestures
Input text
Press keys

App Management

Install/uninstall apps
Start/stop apps
List installed apps
Get app information

File Operations

Push files to device
Pull files from device
List files and directories
Create directories
Delete files

Shell Commands

Execute shell commands
Get system information
Get battery information
Get logcat output

📦 Installation

Clone the repository
Install dependencies:
```
npm install
```
Build the project:
```
npm run build
```

💻 Usage Examples

Prerequisites

Android Debug Bridge (adb) must be installed and available in PATH
Android device connected via USB with USB debugging enabled
Device must be authorized for debugging

Running the Server

npm start

Available Tools

Device Management

adb_list_devices - List all connected devices
adb_get_device_info - Get device information
adb_set_default_device - Set default device

Screen Operations

adb_screenshot - Take screenshot
adb_click - Click at coordinates
adb_swipe - Swipe gesture
adb_input_text - Input text
adb_press_key - Press key

App Management

adb_install_app - Install APK
adb_uninstall_app - Uninstall app
adb_start_app - Start app
adb_stop_app - Stop app
adb_list_apps - List installed apps

File Operations

adb_push_file - Push file to device
adb_pull_file - Pull file from device
adb_list_files - List files in directory

Shell Commands

adb_shell - Execute shell command
adb_get_system_info - Get system information
adb_get_battery_info - Get battery information
adb_get_logcat - Get logcat output

🔧 Technical Details

The server includes basic security measures:

Dangerous shell commands are blocked
File path validation
Device connection verification
Input sanitization

📚 Documentation

Build

npm run build

Development Mode

npm run dev

Lint

npm run lint

MCP

      "mcpServers": {
        "adb-mcp": {
          "type": "stdio",
          "command": "node",
          "args": [
            "/adb-mcp/dist/index.js"
          ],
          "env": {
            "ADB_DOWNLOAD_PATH": "/adb-mcp",
            "MCP_READ_PATH": "/adb-mcp"
          }
        }
      }

📄 License

MIT

adb_list_devices

List all connected Android devices

adb_get_device_info

Get detailed information about a specific device

Parameters

deviceId : string*

Description

Device ID (optional, uses default device if not specified)

adb_set_default_device

Set the default device for subsequent operations

Parameters

deviceId : string*

Description

Device ID to set as default

adb_screenshot

Take a screenshot of the device screen

Parameters

deviceId : string*

Description

Device ID (optional)

Parameters

format : string*

Description

Screenshot format (default: png)

adb_click

Click at specific coordinates on the device screen

Parameters

x : number*

Description

X coordinate

Parameters

y : number*

Description

Y coordinate

Parameters

deviceId : string*

Description

Device ID (optional)

adb_swipe

Swipe from one point to another on the device screen

Parameters

x1 : number*

Description

Start X coordinate

Parameters

y1 : number*

Description

Start Y coordinate

Parameters

x2 : number*

Description

End X coordinate

Parameters

y2 : number*

Description

End Y coordinate

Parameters

duration : number*

Description

Swipe duration in milliseconds (default: 300)

Parameters

deviceId : string*

Description

Device ID (optional)

adb_input_text

Input text on the device

Parameters

text : string*

Description

Text to input

Parameters

deviceId : string*

Description

Device ID (optional)

adb_press_key

Press a key on the device

Parameters

keyCode : [ "string", "number" ]*

Description

Key code to press (e.g., 'BACK', 'HOME', 'MENU', or numeric code)

Parameters

deviceId : string*

Description

Device ID (optional)

adb_install_app

Install an APK file on the device

Parameters

apkPath : string*

Description

Path to the APK file

Parameters

deviceId : string*

Description

Device ID (optional)

adb_uninstall_app

Uninstall an app from the device

Parameters

packageName : string*

Description

Package name of the app to uninstall

Parameters

deviceId : string*

Description

Device ID (optional)

adb_start_app

Start an app on the device

Parameters

packageName : string*

Description

Package name of the app to start

Parameters

activityName : string*

Description

Activity name (optional)

Parameters

deviceId : string*

Description

Device ID (optional)

adb_stop_app

Stop an app on the device

Parameters

packageName : string*

Description

Package name of the app to stop

Parameters

deviceId : string*

Description

Device ID (optional)

adb_list_apps

List installed apps on the device

Parameters

deviceId : string*

Description

Device ID (optional)

adb_push_file

Push a file from local system to device

Parameters

localPath : string*

Description

Local file path

Parameters

remotePath : string*

Description

Remote file path on device

Parameters

deviceId : string*

Description

Device ID (optional)

adb_pull_file

Pull a file from device to local system

Parameters

remotePath : string*

Description

Remote file path on device

Parameters

localPath : string*

Description

Local file path (optional)

Parameters

deviceId : string*

Description

Device ID (optional)

adb_list_files

List files in a directory on the device

Parameters

remotePath : string*

Description

Remote directory path on device

Parameters

deviceId : string*

Description

Device ID (optional)

adb_shell

Execute a shell command on the device

Parameters

command : string*

Description

Shell command to execute

Parameters

deviceId : string*

Description

Device ID (optional)

adb_get_system_info

Get system information from the device

Parameters

deviceId : string*

Description

Device ID (optional)

adb_get_battery_info

Get battery information from the device

Parameters

deviceId : string*

Description

Device ID (optional)

adb_get_logcat

Get logcat output from the device

Parameters

lines : number*

Description

Number of lines to retrieve (default: 100)

Parameters

tag : string*

Description

Filter by tag (optional)

Parameters

deviceId : string*

Description

Device ID (optional)

Notion Api MCP

Certified

A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.

The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.

TypeScript

25.2K

4.3 points

Duckduckgo MCP Server

Certified

The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.

Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.

Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.

UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.

32.3K

5 points

Gmail MCP Server

A Gmail automatic authentication MCP server designed for Claude Desktop, supporting Gmail management through natural language interaction, including complete functions such as sending emails, label management, and batch operations.

The MiniMax Model Context Protocol (MCP) is an official server that supports interaction with powerful text-to-speech, video/image generation APIs, and is suitable for various client tools such as Claude Desktop and Cursor.

Python

49.5K

4.8 points

Zhiqi Future, Your AI Solution Think Tank

English 简体中文繁體中文にほんご

Adb MCP

Overview

Tools List

Content Details

Alternatives

What is the ADB MCP Server?

How to use the ADB MCP Server?

Applicable Scenarios

Main Features

How to Use

Usage Examples

Frequently Asked Questions

Related Resources

Installation

🚀 ADB MCP

🚀 Quick Start

✨ Features

Device Management

Screen Operations

App Management

File Operations

Shell Commands

📦 Installation

💻 Usage Examples

Prerequisites

Running the Server

Available Tools

Device Management

Screen Operations

App Management

File Operations

Shell Commands

🔧 Technical Details

📚 Documentation

Build

Development Mode

Lint

MCP

📄 License

Alternatives