mcp-server-adb logo

mcp-server-adb

by yava555

mcp-server-adb is a TypeScript-based Model Context Protocol (MCP) server that enables AI assistants to interact with Android devices through ADB commands. It provides resources for device discovery, tools for device control, and prompts for device analysis.

View on GitHub

Last updated: N/A

What is mcp-server-adb?

mcp-server-adb is a Model Context Protocol server designed to control Android devices using the Android Debug Bridge (ADB). It allows AI assistants and other applications to programmatically interact with Android devices, enabling automation and remote control capabilities.

How to use mcp-server-adb?

To use mcp-server-adb, you need Node.js, ADB installed and configured, and an Android device with USB debugging enabled. Install the dependencies using npm install, build the server with npm run build, and then configure your MCP client (e.g., Claude Desktop) to point to the built index.js file. Use the provided tools and prompts to interact with the connected Android device.

Key features of mcp-server-adb

  • Device discovery and information retrieval

  • Device control (tap, swipe, input text, press key)

  • Screenshot capture

  • Application management (install, uninstall, start, stop - Coming Soon)

  • Device and screen analysis prompts

Use cases of mcp-server-adb

  • Automated testing of Android applications

  • Remote control of Android devices for assistance or demonstration

  • AI-driven analysis of Android device state and application behavior

  • Integration with AI assistants for hands-free Android device control

FAQ from mcp-server-adb

What is ADB?

ADB stands for Android Debug Bridge. It is a command-line tool that allows you to communicate with an Android device.

How do I enable USB debugging?

Go to Settings > About phone, tap 'Build number' 7 times to enable Developer options. Then, go to Settings > Developer options and enable 'USB debugging'.

What is MCP?

MCP stands for Model Context Protocol. It is a protocol for communication between AI models and external tools or services.

How do I connect to a device over network?

Connect the device via USB first, enable 'Wireless debugging' in Developer options, and then use the connect_device tool with the device's IP address.

How do I debug the MCP server?

Use the MCP Inspector by running npm run inspector. This will provide a URL to access debugging tools in your browser.