JinDaGe - adb-mcp MCP Details

article

README

🚀 ADB MCP 服务器

ADB MCP 服务器是一款基于 TypeScript 的工具，它借助 Android Debug Bridge (ADB) 实现与安卓设备的交互。该工具在 AI 模型和安卓设备功能之间搭建了一座桥梁，为相关开发和测试工作提供了便利。

🚀 快速开始

在使用 ADB MCP 服务器之前，请确保满足以下先决条件：

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

✨ 主要特性

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

📦 安装指南

# 克隆仓库
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] 协议。

adb-mcp