Skip to main content
Glama

ADB MCP Server

by richard0913
MIT License

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

-
security - not tested
A
license - permissive license
-
quality - not tested

A Model Context Protocol server that provides Android Debug Bridge functionality for automating Android devices, enabling remote device management, screen operations, app management, file operations, and shell command execution.

  1. Features
    1. Device Management
    2. Screen Operations
    3. App Management
    4. File Operations
    5. Shell Commands
  2. Installation
    1. Usage
      1. Prerequisites
      2. Running the Server
      3. Available Tools
    2. Security
      1. Development
        1. Build
        2. Development Mode
        3. Lint
        4. MCP
      2. License

        Related MCP Servers

        • A
          security
          A
          license
          A
          quality
          A Model Context Protocol (MCP) server that enables AI assistants to control and interact with Android devices, allowing for device management, app debugging, system analysis, and UI automation through natural language commands.
          Last updated -
          29
          143
          Python
          Apache 2.0
          • Linux
          • Apple
        • -
          security
          A
          license
          -
          quality
          A Model Context Protocol server that enables AI assistants to interact with Android devices through ADB, allowing for automated device management, app installation, file transfers, and screenshot capture.
          Last updated -
          11
          2
          JavaScript
          ISC License
          • Linux
          • Apple
        • -
          security
          A
          license
          -
          quality
          A Model Context Protocol server that enables building Android projects and running tests directly in Visual Studio Code through extensions like Cline or Roo Code.
          Last updated -
          1
          Python
          MIT License
        • -
          security
          A
          license
          -
          quality
          A Model Context Protocol server that enables AI agents to control and automate Android devices through natural language, supporting actions like app management, UI interactions, and device monitoring.
          Last updated -
          2
          Python
          MIT License
          • Apple

        View all related MCP servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/richard0913/adb-mcp'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server