Android ADB MCP Server

Android MCP 服务器

一个通过 ADB（Android Debug Bridge）提供 Android 设备编程控制的 MCP（Model Context Protocol）服务器。该服务器暴露多种 Android 设备管理能力，可被 MCP 客户端访问，例如 Claude Desktop 和代码编辑器（如 Cursor、Kiro）。

功能特性

• 🔧 ADB 命令执行
• 📸 设备屏幕截图
• 🔍 截图 OCR 文字识别
• 🎯 UI 布局分析
• 📱 设备应用包管理
• 👆 触摸操作（点击、滑动、长按、文本输入、按键）
• 🚀 应用管理（启动、停止、安装、卸载）
• 📂 文件传输（推送、拉取）
• 🔋 设备信息与电池状态
• 📹 屏幕录制
• 📋 日志获取
• 📶 WiFi 开关控制
• ⏳ 元素等待

前置要求

• Python 3.11+
• ADB（Android Debug Bridge）已安装并配置
• Android 设备或模拟器（模拟器未经测试）
• Tesseract OCR 引擎（用于文字识别功能）

安装

方式一：通过 pip 安装（推荐）

pip install android-adb

方式二：通过 uvx 直接运行（无需安装）

uvx android-adb

方式三：从源码安装

git clone https://github.com/xuegao-tzx/android-adb-mcp.git
cd android-adb-mcp
uv pip install -e "."

安装 Tesseract OCR 引擎

# Ubuntu/Debian
sudo apt install tesseract-ocr

# macOS (使用 Homebrew)
brew install tesseract

# Windows
# 从以下地址下载安装程序: https://github.com/UB-Mannheim/tesseract/wiki

配置

服务器支持灵活的设备配置，适用于多种使用场景。

配置文件查找顺序

服务器会按以下顺序查找 config.yaml：

1. 当前工作目录下的 config.yaml
2. ~/.android-adb/config.yaml（用户 home 目录）

如果未找到配置文件，服务器会在仅连接一个设备时自动选择。

设备选择模式

1. 自动选择（单设备推荐）

• 无需配置文件
• 自动连接唯一已连接的设备

2. 手动指定设备

创建 config.yaml：

device:
  name: "your-device-serial-here"  # 来自 'adb devices' 的设备标识符

查找设备序列号

adb devices

输出示例：

List of devices attached
13b22d7f        device
emulator-5554   device

使用第一列的值作为设备名称。

使用场景

使用方法

需要 MCP 客户端来使用此服务器。

Claude Desktop

在 Claude Desktop 配置文件中添加：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

pip 安装方式：

{
  "mcpServers": {
    "android": {
      "command": "android-adb"
    }
  }
}

uvx 方式（无需预安装）：

{
  "mcpServers": {
    "android": {
      "command": "uvx",
      "args": ["android-adb"]
    }
  }
}

Kiro / Cursor 等编辑器

在项目的 MCP 配置文件中添加：

{
  "mcpServers": {
    "android": {
      "command": "uvx",
      "args": ["android-adb"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

可用工具

服务器暴露以下 41 个工具：

基础工具

触摸与输入操作

应用管理

设备信息与文件管理

设备设置

剪贴板

进阶能力

贡献

欢迎贡献代码！

致谢

• 基于 Model Context Protocol (MCP) 构建