adb_screenshot_mcp

hawier-dev/adb_screenshot_mcp

3.3

If you are the rightful owner of adb_screenshot_mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

MCP server for taking Android screenshots via ADB.

Tools
2
Resources
0
Prompts
0

ADB Screenshot MCP Server

MCP server for taking Android screenshots via ADB.

Installation

git clone https://github.com/hawier-dev/adb_screenshot_mcp.git
cd adb_screenshot_mcp
./install.sh

The installation script will:

  • Create Python virtual environment
  • Install dependencies
  • Optionally configure your MCP client automatically

Manual Configuration

If automatic configuration didn't work, add to your MCP client configuration:

{
  "mcpServers": {
    "adb-screenshot": {
      "command": "/absolute/path/to/adb_screenshot_mcp/run.sh"
    }
  }
}

Replace /absolute/path/to/adb_screenshot_mcp/ with the actual path where you cloned the repository.

Then restart your MCP client.

Requirements

  • Python 3.10+
  • ADB (Android Debug Bridge)
  • Android device with USB debugging enabled

Available Tools

take_screenshot

Takes a screenshot from a connected Android device.

Parameters:

  • device_id (string, optional) - Device ID when multiple devices are connected
  • filename (string, optional) - Custom filename without extension
  • delay (number, optional) - Delay in seconds before taking screenshot (default: 1)

Returns: Screenshot image in base64 format

list_devices

Lists all connected Android devices via ADB.

Parameters: None

Returns: List of connected device IDs

Usage Examples

Take a screenshot
Take a screenshot in 3 seconds
Show connected devices
Take a screenshot from device [device_id]

License

MIT