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               # 主 MCP 服务器入口点
│   ├── handlers/              # 每个功能的请求处理程序
│   │   ├── deviceList.ts      # 设备列表功能
│   │   ├── screenshot.ts      # 屏幕截图捕获功能
│   │   └── uiElements.ts      # UI 层次结构提取
│   ├── utils/                 # 实用函数
│   │   ├── adb.ts             # ADB 命令执行实用程序
│   │   └── screenshot.ts      # 屏幕截图处理实用程序
│   └── types/                 # TypeScript 类型定义
├── package.json               # 项目依赖和脚本
└── tsconfig.json              # TypeScript 配置

贡献

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

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。