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

npm install
npm run build

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

npm start

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