ADB Screenshot MCP Server

A Model Context Protocol (MCP) server that provides ADB tools for connecting to Android devices over WiFi and taking screenshots.

Features

• WiFi Connection: Connect to Android devices over WiFi using ADB

• Screenshot Capture: Take screenshots of connected devices

• Device Management: List devices, get device info, and disconnect

• Remote Access: Perfect for accessing devices on the same network

Prerequisites

• ADB (Android Debug Bridge) installed and in your PATH

• Android device with USB debugging enabled

• For WiFi connection: Device and computer on the same network

Installation

Usage

Enable WiFi ADB on your Android device:

1. Connect device via USB first

2. Run: adb tcpip 5555

3. Disconnect USB and find device IP address

4. Use the adb_connect_wifi tool with the IP address

Available Tools

1. adb_connect_wifi: Connect to device over WiFi

   • ip_address: Device IP address (required)

   • port: Port number (default: 5555)

2. adb_screenshot: Take a screenshot

   • output_path: Save location (default: screenshot.png)

   • device_id: Specific device (optional)

3. adb_list_devices: List all connected devices

4. adb_disconnect: Disconnect from WiFi device

   • ip_address: Device IP address (required)

   • port: Port number (default: 5555)

5. adb_device_info: Get device information

   • device_id: Specific device (optional)

Running the Server

Example Workflow

1. Enable WiFi ADB: adb tcpip 5555

2. Connect: Use adb_connect_wifi with device IP

3. Take screenshot: Use adb_screenshot

4. Disconnect: Use adb_disconnect when done