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

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

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

Security

The server includes basic security measures:

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

Development

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