ADB MCP Server
2025.04.15
0
TypeScript设备管理截图捕获UI 元素检查ADB 命令执行浏览器自动化开发效率
ADB MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，用于管理 Android Debug Bridge (ADB) 连接并与 Android 设备进行交互。该服务提供了设备管理、截图捕获、UI 元素检查和 ADB 命令执行等功能，适用于 Android 设备调试、自动化测试和开发场景。
View on GitHub
Overview
基本能力
产品定位
ADB MCP Server 是一个用于管理和交互 Android 设备的 MCP 服务，主要用于 Android 设备的调试、自动化测试和开发。
核心功能
- 设备管理：列出所有连接的 Android 设备。
- 截图捕获：从连接的设备中捕获屏幕截图。
- UI 元素检查：提取设备屏幕的 UI 层次结构。
- ADB 命令执行：在连接的设备上执行任意 ADB 命令。
适用场景
- Android 设备调试
- 自动化测试
- 开发工具集成
工具列表
- List Connected Devices (
get_devices): 列出所有连接的 Android 设备及其 ID 和连接状态。 - Capture Screenshot (
capture_screenshot): 从指定设备捕获屏幕截图并保存到指定路径。 - Get UI Elements (
get_ui_elements): 提取指定设备的 UI 层次结构（XML 格式），适用于 UI 自动化和测试。 - Execute ADB Command (
execute_adb_command): 在指定设备上执行任意 ADB 命令。
常见问题解答
- 依赖问题：确保 ADB 已安装并添加到系统 PATH 中。
- 设备连接问题：确保设备已通过 USB 或网络正确连接并授权调试。
使用教程
使用依赖
- 安装 Android Debug Bridge (ADB) 并添加到系统 PATH。
- 安装 Node.js (v14 或更高版本)。
- 安装 TypeScript。
安装教程
- 克隆仓库：
git clone https://github.com/yourusername/adb-mcp-server.git cd adb-mcp-server - 安装依赖：
npm install - 构建项目：
npm run build
调试方式
- 启动服务器（MCP over stdio）：
npm start - 开发模式（自动重启）：
npm run dev - 使用工具命令（如
get_devices、capture_screenshot等）进行调试。