ADB

An MCP (Model Context Protocol) server for interacting with Android devices through ADB in TypeScript.

javascript

35

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "srmorete-adb-mcp": {
      "command": "npx",
      "args": [
        "adb-mcp"
      ],
      "env": {
        "ADB_PATH": "/path/to/adb",
        "LOG_LEVEL": "3"
      }
    }
  }
}

You have a dedicated MCP server that bridges AI models with Android devices via ADB. It lets you manage devices, install apps, access logs, transfer files, capture UI data, and run shell commands, all through a lightweight, scriptable interface that AI tools can leverage.

How to use

Start by launching the MCP server so your MCP client can communicate with Android devices. Run npx adb-mcp in a terminal and keep that window open while you work with ADB tools.

How to install

Prerequisites include Node.js (v16 or higher recommended) and ADB installed and available in your PATH. You also need a connected Android device or emulator with USB debugging enabled and authorized.

Install via Smithery to automate setup on Claude Desktop:

npx -y @smithery/cli install @srmorete/adb-mcp --client claude

Manual installation steps you can run locally:

# Clone the repository
git clone https://github.com/srmorete/adb-mcp.git
cd adb-mcp

# Install dependencies
npm install

# Build the TypeScript code
npm run build

# Run the server
npx adb-mcp

Configure ADB path if you have a custom location, then start the server:

export ADB_PATH=/path/to/adb
npx adb-mcp

Configuration and startup details

To route your MCP client to this ADB MCP server, include a server entry that points to the local npm-based runner. The example below shows the exact configuration you can add to your MCP configuration file.

{
  "mcpServers": {
    "adb": {
      "command": "npx",
      "args": [
        "adb-mcp"
      ]
    }
  }
}

Security and reliability notes

Ensure you keep the MCP server running in a stable environment. If you encounter issues, check the server output for error messages and consider running with elevated logging to diagnose problems.

Available tools

adb_devices

List connected Android devices.

adb_shell

Execute shell commands on a connected device.

adb_install

Install an APK file from a local path to a device.

adb_package_manager

Run Package Manager (pm) commands to manage apps and permissions.

adb_activity_manager

Run Activity Manager (am) commands to start activities or send intents.

adb_logcat

View device logs with optional filters.

adb_pull

Pull files from a device to the host.

adb_push

Push files from the host to a device.

dump_image

Capture a screenshot of the current device screen.

inspect_ui

Retrieve the UI hierarchy in XML format for analysis.