MCPgee
MCPgee
MCPgeeMCPgee

Android ADB

v1.0.0•Developer Tools•stable

通过AI大模型操作安卓设备

mcp-android-adbmcpai-integration
Share:
25
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Android ADB?

Android ADB is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 通过ai大模型操作安卓设备

通过AI大模型操作安卓设备

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • 通过AI大模型操作安卓设备

Use Cases

Control Android devices through AI agents via ADB protocol.
github-hewei

Maintainer

LicenseGPL-3.0
Languagego
Versionv1.0.0
UpdatedMar 4, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx mcp-android-adb

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Android ADB

The Android ADB MCP server lets AI assistants control Android devices directly through the Android Debug Bridge (ADB) protocol. It exposes tools for app management, screen control, input simulation, and gesture execution, enabling AI agents to automate mobile workflows, run UI tests, or interact with apps hands-free. Developers and QA engineers can use it to drive Android devices from within their AI-powered tooling without touching the device or writing separate automation scripts.

Prerequisites

  • Go 1.20+ installed to build from source (or use a pre-built binary)
  • Android Debug Bridge (ADB) installed and in your PATH
  • An Android device or emulator connected and visible via `adb devices`
  • Device ID ready (from `adb devices` output)
  • An MCP-compatible client such as Claude Desktop
1

Install ADB and connect your device

Install Android Debug Bridge from the Android SDK Platform Tools. Connect your Android device via USB or start an emulator, then run `adb devices` to confirm the device is listed and note its device ID.

adb devices
2

Clone and build the server

Clone the repository and build the Go binary. The resulting binary will be the executable you point your MCP client at.

git clone https://github.com/github-hewei/mcp-android-adb-server.git
cd mcp-android-adb-server
go build -o mcp-android-adb .
3

Set required environment variables

At minimum, set DEVICE_ID to the ID of your target Android device. Optionally set SCREEN_LOCK_PASSWORD if the device has a PIN/password lock, and VISUAL_MODEL_ON plus related keys if you want screenshot analysis via a vision model.

export DEVICE_ID=emulator-5554
export SCREEN_LOCK_PASSWORD=1234
export VISUAL_MODEL_ON=true
export VISUAL_MODEL_API_KEY=your_openrouter_key
export VISUAL_MODEL_BASE_URL=https://openrouter.ai/api/v1
export VISUAL_MODEL_NAME=qwen/qwen2.5-vl-72b-instruct:free
4

Configure your MCP client

Add the server to your MCP client configuration. The command should point to the built binary and pass the required environment variables.

5

Restart your MCP client

Save the configuration and restart Claude Desktop or your MCP client. The Android ADB tools will appear in the tool list once the server connects successfully.

Android ADB Examples

Client configuration

Example claude_desktop_config.json entry for the Android ADB MCP server using the built binary.

{
  "mcpServers": {
    "android-adb": {
      "command": "/path/to/mcp-android-adb",
      "args": [],
      "env": {
        "DEVICE_ID": "emulator-5554",
        "SCREEN_LOCK_PASSWORD": "",
        "VISUAL_MODEL_ON": "false"
      }
    }
  }
}

Prompts to try

Sample prompts to control your Android device through Claude once the server is connected.

- "Open the Settings app on my Android device"
- "Take a screenshot and describe what's on the screen"
- "Swipe up on the device to scroll down"
- "Install the APK at /tmp/myapp.apk on the device"
- "Type 'Hello World' into the currently focused text field"

Troubleshooting Android ADB

Server fails to start with 'no devices found' or similar ADB error

Run `adb devices` to confirm the device is listed. If it shows 'unauthorized', unlock the device and accept the RSA key prompt. Ensure DEVICE_ID exactly matches the ID shown by `adb devices`.

Visual model features return errors or empty descriptions

Ensure VISUAL_MODEL_ON is set to 'true', and that VISUAL_MODEL_API_KEY, VISUAL_MODEL_BASE_URL, and VISUAL_MODEL_NAME are all correctly set. Test the API key directly with a curl request to the provider endpoint.

Screen unlock fails even with SCREEN_LOCK_PASSWORD set

Verify the password value matches your device's actual PIN or password. For pattern locks, ADB unlock via password may not work — consider disabling the screen lock during development testing.

Frequently Asked Questions about Android ADB

What is Android ADB?

Android ADB is a Model Context Protocol (MCP) server that 通过ai大模型操作安卓设备 It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Android ADB?

Follow the installation instructions on the Android ADB GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Android ADB?

Android ADB works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Android ADB free to use?

Yes, Android ADB is open source and available under the GPL-3.0 license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Android ADB Alternatives — Similar Developer Tools Servers

Looking for alternatives to Android ADB? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.

Ecc

★ 188.2k

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Javaguide

★ 155.8k

Java 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发

Gemini CLI

★ 104.5k

A secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in

Awesome MCP Servers

★ 87.3k

⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.

MCP Servers

★ 86.0k

Model Context Protocol Servers

CC Switch

★ 77.5k

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Developer ToolsBrowse All Servers

Quick Config Preview

{ "mcpServers": { "mcp-android-adb": { "command": "npx", "args": ["-y", "mcp-android-adb"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Android ADB?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides