ADB-MCP: Integrated MCP Server for Android Screenshots via ADB over WiFi

Explore

Adb MCP

An MCP server that connects to Android devices via WiFi and takes screenshots using ADB tools

Developer tools Monitoring #ADB Tools #WiFi Connection #Screenshot Service #Device Management .TypeScript

rating : 2 points

downloads : 6.1K

update time : 2025-07-29

Open Site

What is the ADB Screenshot MCP Server?

This is a server based on the Model Context Protocol (MCP), specifically designed to connect to Android devices via WiFi and capture screenshots. It simplifies the remote management process of Android devices, especially suitable for scenarios where frequent device screen captures are required.

How to use the ADB Screenshot MCP Server?

Simply install the Node.js environment, configure the ADB tools, and then connect to the device and capture screenshots through simple commands. The entire process does not require physical contact with the device.

Applicable Scenarios

Suitable for scenarios such as remote technical support, automated testing, and device monitoring that require capturing the screen of Android devices. Particularly suitable for environments where multiple devices are managed simultaneously.

Main Features

WiFi Connection

Connect to Android devices via WiFi network without USB cables

Screenshot Capture

Remotely capture device screenshots and save them to the specified location

Device Management

View the device list, obtain device information, and disconnect the connection

Advantages

Capture screenshots without physical contact with the device

Support multi - device management on the same network

Simple operation with a friendly command - line interface

Limitations

Need to enable the debugging mode via USB in advance

The device and the computer must be on the same network

Depend on the correct configuration of the ADB tools

How to Use

Installation Preparation

Ensure that Node.js and ADB tools are installed, and add ADB to the system PATH

Enable WiFi Debugging

Connect the device via USB and enable the WiFi debugging mode for the first time

Start the Server

Run the MCP server to start receiving commands

Connect the Device

Connect to the target Android device via WiFi

Usage Examples

Remote Technical Support

Technical support staff can capture screenshots to analyze problems without touching the user's device

Multi - Device Monitoring

Monitor the screen content of multiple display devices simultaneously

Frequently Asked Questions

Why can't I connect to the device via WiFi?

Where are the screenshots saved?

How to view the list of connected devices?

Related Resources

ADB Official Documentation

Official usage guide for Android Debug Bridge

Node.js Installation Guide

Download and installation instructions for Node.js

MCP Protocol Description

Technical specification for the Model Context Protocol

🚀 ADB Screenshot MCP Server

A Model Context Protocol (MCP) server that offers ADB tools to connect to Android devices via WiFi and capture screenshots.

🚀 Quick Start

The ADB Screenshot MCP Server allows you to conveniently connect to Android devices over WiFi and take screenshots. Follow the steps below to get started.

✨ Features

WiFi Connection: Leverage ADB to connect to Android devices over WiFi.
Screenshot Capture: Take screenshots of the connected Android devices.
Device Management: List connected devices, retrieve device information, and disconnect from devices.
Remote Access: Ideal for accessing devices on the same network.

📦 Installation

npm install
npm run build

💻 Usage Examples

Basic Usage

Enable WiFi ADB on your Android device:

First, connect your device to the computer via USB.
Run the command: adb tcpip 5555.
Disconnect the USB cable and find the IP address of your device.
Use the adb_connect_wifi tool with the device's IP address.

Advanced Usage

Available Tools

adb_connect_wifi: Connect to a device over WiFi.
- ip_address: The IP address of the device (required).
- port: The port number (default: 5555).
adb_screenshot: Capture a screenshot.
- output_path: The location to save the screenshot (default: screenshot.png).
- device_id: The specific device (optional).
adb_list_devices: List all the connected devices.
adb_disconnect: Disconnect from a WiFi - connected device.
- ip_address: The IP address of the device (required).
- port: The port number (default: 5555).
adb_device_info: Retrieve device information.
- device_id: The specific device (optional).

Running the Server

npm start

Example Workflow

Enable WiFi ADB: adb tcpip 5555.
Connect: Use adb_connect_wifi with the device's IP address.
Take a screenshot: Use adb_screenshot.
Disconnect: Use adb_disconnect when you are finished.

📚 Documentation

Prerequisites

ADB (Android Debug Bridge) should be installed and added to your system's PATH.
Your Android device must have USB debugging enabled.
For WiFi connection, ensure that both the device and the computer are on the same network.