adb-mcp-server

adb-mcp-server

3.2
os_automationdeveloper_tools

If you are the rightful owner of adb-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A Model Context Protocol (MCP) server for managing Android Debug Bridge (ADB) connections and interacting with Android devices.

ADB MCP Server

A Model Context Protocol (MCP) server for managing Android Debug Bridge (ADB) connections and interacting with Android devices.

Features

  • Device Management: List all connected Android devices
  • Screenshot Capture: Take screenshots from connected devices
  • UI Element Inspection: Extract UI hierarchy from device screens
  • ADB Command Execution: Run arbitrary ADB commands on connected devices

Prerequisites

  • Android Debug Bridge (ADB) must be installed on your system and added to your PATH
  • Node.js (v14 or higher)
  • TypeScript

Installation

  1. Clone the repository:

    git clone https://github.com/yourusername/adb-mcp-server.git
cd adb-mcp-server

  2. Install the dependencies:

    npm install

  3. Build the project:

    npm run build

Usage

Starting the Server

The ADB MCP server runs as a Model Context Protocol server over stdio:

npm start

For development with auto-restart on file changes:

npm run dev

Available Tools

The server exposes the following MCP tools:

1. List Connected Devices
get_devices

Returns a list of all connected Android devices with their IDs and connection states.

2. Capture Screenshot
capture_screenshot

Parameters:

  • deviceId: ID of the device to capture from
  • path: Path where the screenshot will be saved

The screenshot will be named according to the format: YYYYMMDD_HH_MM_SS.png

3. Get UI Elements
get_ui_elements

Parameters:

  • deviceId: ID of the device to extract UI hierarchy from

Returns the full UI hierarchy in XML format, useful for UI automation and testing.

4. Execute ADB Command
execute_adb_command

Parameters:

  • deviceId: ID of the device to run the command on
  • command: The ADB command to execute

Allows execution of arbitrary ADB commands on the specified device.

Project Structure

adb-mcp-server
ā”œā”€ā”€ src
ā”‚   ā”œā”€ā”€ index.ts               # Main MCP server entry point
ā”‚   ā”œā”€ā”€ handlers/              # Request handlers for each feature
ā”‚   ā”‚   ā”œā”€ā”€ deviceList.ts      # Device listing functionality
ā”‚   ā”‚   ā”œā”€ā”€ screenshot.ts      # Screenshot capture functionality
ā”‚   ā”‚   ā””ā”€ā”€ uiElements.ts      # UI hierarchy extraction
ā”‚   ā”œā”€ā”€ utils/                 # Utility functions
ā”‚   ā”‚   ā”œā”€ā”€ adb.ts             # ADB command execution utilities
ā”‚   ā”‚   ā””ā”€ā”€ screenshot.ts      # Screenshot handling utilities
ā”‚   ā””ā”€ā”€ types/                 # TypeScript type definitions
ā”œā”€ā”€ package.json               # Project dependencies and scripts
ā””ā”€ā”€ tsconfig.json              # TypeScript configuration

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Related MCP Servers

View all os_automation servers ā†’
mcp-shrimp-task-manager

mcp-shrimp-task-manager

4.6

by cjo4m06

MCP Shrimp Task Manager is an intelligent task management system based on Model Context Protocol (MCP), designed to enhance programming workflows for AI Agents.

os_automation
mcp-n8n-workflow-builder

mcp-n8n-workflow-builder

4.2

by salacoste

The n8n Workflow Builder MCP Server is designed to manage n8n workflows using the Model Context Protocol, allowing seamless integration with Claude AI and Cursor IDE.

cloud_platforms
mcp-datetime

mcp-datetime

4.0

by ZeparHyfar

A datetime formatting service implemented as an MCP server for the Claude Desktop Application.

developer_tools
Cua Agent

Cua Agent

3.8

by trycua

cua-mcp-server is a Model Context Protocol (MCP) server for the Computer-Use Agent (CUA), enabling integration with Claude Desktop and other MCP clients.

developer_tools
tabby-mcp-server

tabby-mcp-server

3.8

by thuanpham582002

Tabby-MCP-Server is a powerful plugin that implements a Model Context Protocol (MCP) server, enabling AI-powered terminal control and automation.

ai_chatbot
kubectl-mcp-server

kubectl-mcp-server

3.7

by rohitg00

Kubectl MCP Server is a Model Context Protocol server for Kubernetes, enabling AI assistants to interact with Kubernetes clusters using natural language.

os_automation
qgis_mcp

qgis_mcp

3.7

by jjsantos01

QGISMCP connects QGIS to Claude AI through the Model Context Protocol, enabling direct interaction and control over QGIS.

cloud_platforms
claude-code-mcp

claude-code-mcp

3.7

by steipete

An MCP (Model Context Protocol) server that allows running Claude Code in one-shot mode with permissions bypassed automatically.

developer_tools
godot-mcp

godot-mcp

3.7

by Coding-Solo

A Model Context Protocol (MCP) server for interacting with the Godot game engine.

os_automation
iterm-mcp

iterm-mcp

3.7

by ferrislucas

A Model Context Protocol server that provides access to your iTerm session.

developer_tools
todoist-mcp-server

todoist-mcp-server

3.7

by abhiz123

An MCP server implementation that integrates Claude with Todoist, enabling natural language task management.

os_automation
FluxCD MCP Server

FluxCD MCP Server

3.6

by controlplaneio-fluxcd

The Flux MCP Server connects AI assistants directly to Kubernetes clusters running Flux Operator, enabling GitOps analysis and troubleshooting through natural language.

cloud_platforms
tfmcp

tfmcp

3.6

by nwiizo

tfmcp is a command-line tool that facilitates interaction with Terraform using the Model Context Protocol (MCP), enabling LLMs to manage Terraform environments.

cloud_platforms
mcp-remote-macos-use

mcp-remote-macos-use

3.6

by baryhuang

The first open-source MCP server that enables AI to fully control remote macOS systems.

os_automation
mcp-claude-code

mcp-claude-code

3.6

by SDGLBL

An implementation of Claude Code capabilities using the Model Context Protocol (MCP).

developer_tools
applescript-mcp

applescript-mcp

3.6

by peakmojo

A Model Context Protocol (MCP) server that lets you run AppleScript code to interact with Mac.

os_automation
moling

moling

3.6

by gojue

MoLing is a dependency-free local office automation assistant that interacts with the system through operating system APIs, enabling file system operations and command execution.

os_automation
freecad-mcp

freecad-mcp

3.6

by neka-nat

FreeCAD MCP is a Model Context Protocol server that allows users to control FreeCAD from Claude Desktop, enabling automation and integration of design tasks.

os_automation
mcp-nixos

mcp-nixos

3.6

by utensils

MCP-NixOS is a Model Context Protocol server designed to provide accurate information about NixOS, Home Manager, and nix-darwin configurations, preventing AI assistants from generating incorrect data.

os_automation
mcp-server-commands

mcp-server-commands

3.6

by g0t4

The Model Context Protocol (MCP) server facilitates communication between LLMs and operating systems, allowing for command execution and automation.

os_automation
todoist-mcp-server

todoist-mcp-server

3.6

by mikemc

A Todoist MCP server written in Python, using the Todoist Python API.

os_automation
mcp-server-apple-shortcuts

mcp-server-apple-shortcuts

3.6

by recursechat

A Model Context Protocol (MCP) server that allows AI assistants to control Apple Shortcuts automations on macOS.

os_automation
mcp-1panel

mcp-1panel

3.6

by 1Panel-dev

1Panel MCP Server is an implementation of the Model Context Protocol (MCP) server for 1Panel, providing a range of tools for system, website, certificate, application, and database management.

os_automation
mcp-server-metamcp

mcp-server-metamcp

3.6

by metatool-ai

MetaMCP MCP Server is a proxy server that consolidates multiple MCP servers into a single interface, facilitating the management and routing of tool, prompt, and resource requests.

cloud_platforms
mcp-server-and-gw

mcp-server-and-gw

3.6

by boilingdata

The MCP Gateway, Server, and Client provide a bridge from stdio to HTTP SSE endpoints, facilitating communication between local and remote servers.

os_automation
mcp-server-macos-use

mcp-server-macos-use

3.6

by mediar-ai

Model Context Protocol (MCP) server in Swift for controlling macOS applications using accessibility APIs.

os_automation
ros-mcp-server

ros-mcp-server

3.6

by lpigeon

The ROS MCP Server facilitates the transformation of natural language commands into ROS commands for robot control, supporting both ROS and ROS2 systems.

cloud_platforms