ADB MCP 服务器

一款基于 TypeScript 的工具，用于通过 Android Debug Bridge (ADB) 与安卓设备交互。此工具为 AI 模型与安卓设备功能之间提供了一个桥梁。

功能

• 📱 设备管理 - 列出并操作连接的安卓设备
• 📦 应用安装 - 部署 APK 文件到连接的设备
• 📋 日志记录 - 访问设备的日志信息（通过 logcat）
• 🔄 文件传输 - 在设备与主机之间推送和拉取文件
• 📸 UI 交互 - 捕获屏幕截图并分析 UI 层次结构
• 🔧 Shell 命令执行 - 在设备上运行自定义命令

先决条件

• Node.js (建议 v16 或更高版本，已测试过 Node.js v16、v18 和 v20)
• 已安装并配置 PATH 环境变量的 ADB (Android Debug Bridge)
• 通过 USB 或网络连接到计算机且启用了 USB 调试模式的安卓设备或模拟器
• 访问设备的权限（已接受调试授权）

安装

# 克隆仓库
git clone https://github.com/srmorete/adb-mcp.git
cd adb-mcp

# 安装依赖项
npm install

# 构建 TypeScript 代码
npm run build

# 运行服务器
npx adb-mcp

配置

ADB 路径配置

服务器使用默认的 ADB 路径。如需指定自定义路径：

export ADB_PATH=/path/to/adb
npx adb-mcp

MCP 配置

添加 ADB MCP 服务器配置：

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

使用方法

启动服务器

注意：使用任何 ADB 工具之前，必须确保服务器已启动。

使用以下命令启动服务器：

npx adb-mcp

你应该会看到：

[INFO] ADB MCP 服务器连接并准备就绪

在运行 ADB 工具时，请保持此终端窗口打开。

可用工具

• 设备管理：用于列出和操作连接的安卓设备。
• 应用安装：将 APK 文件部署到连接的设备上。
• 日志记录：通过 logcat 访问设备的日志信息。
• 文件传输：在设备与主机之间推送和拉取文件。
• UI 交互：捕获屏幕截图并分析 UI 层次结构。
• Shell 命令执行：在设备上运行自定义命令。

故障排除

服务器问题

• 如果无法启动服务器，请检查 Node.js 和 npm 是否正确安装，并确保已安装所有依赖项。

设备连接问题

• 确保设备通过 USB 或网络正确连接到计算机。
• 检查设备是否启用了 USB 调试模式。

日志记录问题

• 如果无法查看日志，请检查 logcat 是否正确配置，并确保设备已连接。

兼容性

• 支持的安卓版本：所有支持 ADB 的安卓系统。
• 支持的操作系统：Windows、Linux 和 macOS。

贡献指南

如何贡献

• 提交问题和建议到 GitHub 仓库。
• 创建拉取请求修复问题或添加功能。

许可证

此项目遵循 [LICENSE] 协议。