# Android MCP Tools

A small local MCP server that exposes a safe, explicit subset of Android Debug Bridge automation to AI agents and test runners.

## Tools

- list connected devices;
- tap and swipe by coordinates;
- type into the focused field;
- send HOME, BACK, ENTER and APP_SWITCH keys;
- launch an installed package;
- dump the current UI Automator accessibility hierarchy.

ADB stays local. The server does not publish a device or open a network listener; it communicates through MCP stdio.

## Requirements

- Node.js 20+
- Android platform tools (`adb`)
- USB debugging or a trusted Wi-Fi ADB connection

## Run

```bash
npm install
npm test
npx android-mcp-tools
```

Example MCP configuration:

```json
{
  "mcpServers": {
    "android": {
      "command": "npx",
      "args": ["android-mcp-tools"]
    }
  }
}
```

Set `ADB_BIN` when `adb` is not available through `PATH`.

## Safety

Only devices already trusted by the local ADB installation are accessible. The project contains no device serials, credentials, sessions, screenshots or user data.

## Author

Denis Luzyanin — [github.com/IMP4R](https://github.com/IMP4R)