ADB MCP Server

基本能力

产品定位

ADB MCP Server 是一个用于通过 ADB 与 Android 设备交互的 MCP（Model Context Protocol）服务器，为 AI 模型和 Android 设备功能之间提供桥梁。

核心功能

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

适用场景

• Android 设备管理和调试
• 应用开发和测试
• AI 模型与 Android 设备的交互

工具列表

📱 设备管理

• adb_devices - 列出连接的设备
• adb_shell - 在设备上执行 shell 命令

📦 应用管理

• adb_install - 使用本地文件路径安装 APK 文件

📋 日志记录

• adb_logcat - 查看设备日志，支持可选过滤

🔄 文件传输

• adb_pull - 从设备拉取文件
• adb_push - 推送文件到设备

🔍 UI 交互

• dump_image - 截取当前屏幕的截图
• inspect_ui - 获取 XML 格式的 UI 层次结构（对 AI 交互最有用）

常见问题解答

• 服务器问题：确保服务器正在运行，检查服务器输出中的错误消息，尝试详细日志
• 设备连接：验证连接，如果显示“未授权”，请在设备上接受调试授权
• ADB 问题：验证 ADB 安装
• 设备设置：确保 USB 调试已启用，对于较新的 Android 版本，启用“USB 调试（安全设置）”

使用教程

使用依赖

• Node.js（推荐 v16 或更高版本，测试过 Node.js v16、v18 和 v20）
• ADB（Android Debug Bridge）已安装并在 PATH 中
• 通过 USB 或网络连接的 Android 设备或模拟器，并启用了 USB 调试
• 设备上的调试授权已接受

安装教程

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

# 安装依赖
npm install

# 构建 TypeScript 代码
npm run build

# 运行服务器
npx adb-mcp

调试方式

启动服务器后，可以使用以下命令进行调试：

npx adb-mcp

如果工具无法工作，可以尝试以下步骤： - 确保服务器正在运行 - 检查服务器输出中的错误消息 - 尝试详细日志：LOG_LEVEL=3 npx adb-mcp - 杀死挂起的进程： bash ps aux | grep "adb-mcp" | grep -v grep kill -9 [PID]

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。