🚀 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] 协议。