ADB MCP Server

ADB MCP 服务

用于管理 Android Debug Bridge（ADB）连接并与 Android 设备交互的模型上下文协议（MCP）服务。

功能

• 设备管理：列出所有已连接的 Android 设备
• 截取屏幕截图：从已连接的设备截取屏幕截图
• UI 元素检查：提取设备屏幕上的 UI 层级结构
• 执行 ADB 命令：在已连接的设备上运行任意 ADB 命令

先决条件

• 系统必须已安装 Android Debug Bridge（ADB），并将其添加到 PATH
• Node.js（v14 或更高版本）
• TypeScript

安装

1. 克隆仓库：

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

2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

用法

启动服务

ADB MCP 服务通过标准输入输出（stdio）作为模型上下文协议服务运行：

npm start

在开发过程中，可启用文件更改后自动重启：

npm run dev

可用工具

该服务提供以下 MCP 工具：

1. 列出已连接的设备

get_devices

返回所有已连接 Android 设备的列表，包括其 ID 和连接状态。

2. 截取屏幕截图

capture_screenshot

参数：

• deviceId：要截取屏幕截图的设备 ID
• path：保存屏幕截图的路径

屏幕截图将按以下格式命名：YYYYMMDD_HH_MM_SS.png

3. 获取 UI 元素

get_ui_elements

参数：

• deviceId：要提取 UI 层级结构的设备 ID

以 XML 格式返回完整的 UI 层级结构，可用于 UI 自动化和测试。

4. 执行 ADB 命令

execute_adb_command

参数：

• deviceId：要在其上运行命令的设备 ID
• command：要执行的 ADB 命令

允许在指定设备上执行任意 ADB 命令。

项目结构

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

参与贡献

欢迎贡献！请随时提交 Pull Request。

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。