ADB MCP Server logo

ADB MCP Server

by jiantao88

This is an MCP server for Android Debug Bridge (ADB) that enables Claude to interact with Android devices. It provides a set of tools to manage and interact with connected Android devices.

View on GitHub

Last updated: N/A

What is ADB MCP Server?

The ADB MCP Server is a Node.js application that acts as a bridge between a Large Language Model (LLM) like Claude and Android devices using the Android Debug Bridge (ADB) protocol. It allows the LLM to execute commands on the device and retrieve information.

How to use ADB MCP Server?

  1. Install ADB and configure it in your system's environment variables.
  2. Enable USB debugging on your Android device.
  3. Clone the repository and install the dependencies using npm install.
  4. Build the project using npm run build.
  5. Configure the server in your claude_desktop_config.json or Windsurf settings, providing the path to the built index.js file and the ADB executable.

Key features of ADB MCP Server

  • List connected Android devices

  • List installed packages

  • Input text to the device

  • Install and uninstall APK files

  • Pull and push files to/from the device

  • Capture screenshots

  • Clear app data

  • Reset and grant permissions

Use cases of ADB MCP Server

  • Automated testing of Android applications

  • Remote control of Android devices

  • Data extraction from Android devices

  • Application management on Android devices

FAQ from ADB MCP Server

How do I install ADB?

Download the Android SDK Platform Tools and add the ADB executable to your system's environment variables. Verify the installation using adb version.

How do I enable USB debugging?

On your Android device, go to Settings > About phone and tap the build number 7 times to enable Developer options. Then, enable USB debugging in the Developer options.

What is the purpose of the MCP server?

The MCP server acts as a bridge between an LLM and Android devices, allowing the LLM to interact with and control the devices through ADB commands.

How do I configure the server in Claude Desktop or Windsurf?

Add a new entry in the mcpServers section of the configuration file, specifying the command to execute (node), the path to the server's index.js file, and the path to the ADB executable.

What if ADB is not installed in the default location?

Make sure to update the path to the ADB executable in the server configuration to the correct location.