ADB MCP

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

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

Related MCP server: Android ADB MCP Server

Installation

1. Clone the repository

2. Install dependencies:

   npm install

3. Build the project:

   npm run build

Usage

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

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

Security

The server includes basic security measures:

• Dangerous shell commands are blocked

• File path validation

• Device connection verification

• Input sanitization

Development

Build

Development Mode

Lint

MCP

License

MIT