# 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

```bash
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

```bash
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