What is Mcp Server Adb

mcp-server-adb is a Model Context Protocol server designed for controlling Android devices through the Android Debug Bridge (ADB). It enables AI assistants to perform various operations on Android devices using ADB commands.

Use cases

Use cases include automating app installations, performing device diagnostics, capturing screenshots, and managing applications on Android devices.

How to use

To use mcp-server-adb, ensure you have Node.js 16 or higher and ADB installed. Install the dependencies using ‘npm install’, build the server with ‘npm run build’, and configure it in the Claude Desktop settings as specified in the README.

Key features

Key features include device discovery and information retrieval, device control operations (like tap, swipe, and input text), application management tools (coming soon), and prompts for device analysis and diagnostics.

Where to use

mcp-server-adb can be used in software development, mobile application testing, and automation tasks where interaction with Android devices is required.

mcp-server-adb

A Model Context Protocol server for Android Debug Bridge (ADB) control

This is a TypeScript-based MCP server that implements an ADB control system. It allows AI assistants to interact with Android devices through ADB commands, providing:

• Resources for device discovery and information
• Tools for device control and app management
• Prompts for device analysis and diagnostics

Features

Resources

• List connected devices via device://list
• Access device information via device://{serial}/info
• View installed packages via device://{serial}/packages
• Capture screenshots via device://{serial}/screenshot

Tools

Device Control

• connect_device - Connect to a specified device
• disconnect_device - Disconnect from a device

Device Operations

• tap - Tap on the screen
• swipe - Swipe on the screen
• input_text - Input text
• press_key - Press a key
• take_screenshot - Take a screenshot

Application Management (Coming Soon)

• install_app - Install APK
• uninstall_app - Uninstall application
• start_app - Launch application
• stop_app - Stop application

Prompts

• analyze_device - Analyze device status and specifications
• analyze_app_list - Analyze installed applications
• analyze_screen - Analyze current screen content

Prerequisites

• Node.js 16 or higher
• Android Debug Bridge (ADB) installed and available in PATH
• Android device with USB debugging enabled or network ADB enabled

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

To use with Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-adb": {
      "command": "/path/to/mcp-server-adb/build/index.js"
    }
  }
}

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

Device Setup

1. Enable USB debugging on your Android device:

   • Go to Settings > About phone
   • Tap “Build number” 7 times to enable Developer options
   • Go to Settings > Developer options
   • Enable “USB debugging”

2. For network debugging:

   • Connect device via USB first
   • Enable “Wireless debugging” in Developer options
   • Use connect_device tool with the device’s IP address

License

MIT