adb-mcp

🚀 ADB MCP

ADB MCP 是一个模型上下文协议（MCP）服务器，为自动化安卓设备提供安卓调试桥（ADB）功能，可实现设备管理、屏幕操作、应用管理等一系列自动化操作。

✨ 主要特性

设备管理

• 列出已连接的设备
• 获取设备信息
• 设置操作的默认设备
• 检查设备连接状态

屏幕操作

• 截取屏幕截图
• 在指定坐标处点击
• 执行滑动手势
• 输入文本
• 按下按键

应用管理

• 安装/卸载应用
• 启动/停止应用
• 列出已安装的应用
• 获取应用信息

文件操作

• 将文件推送到设备
• 从设备拉取文件
• 列出文件和目录
• 创建目录
• 删除文件

执行 shell 命令

• 执行 shell 命令
• 获取系统信息
• 获取电池信息
• 获取日志输出

📦 安装指南

1. 克隆仓库
2. 安装依赖：

   npm install
   

3. 构建项目：

   npm run build
   

💻 使用示例

前提条件

• 必须安装安卓调试桥（adb），并且其可在系统的 PATH 中找到
• 通过 USB 连接安卓设备，并启用 USB 调试功能
• 设备必须被授权进行调试

启动服务器

npm start

可用工具

设备管理

• adb_list_devices - 列出所有已连接的设备
• adb_get_device_info - 获取设备信息
• adb_set_default_device - 设置默认设备

屏幕操作

• adb_screenshot - 截取屏幕截图
• adb_click - 在指定坐标处点击
• adb_swipe - 执行滑动手势
• adb_input_text - 输入文本
• adb_press_key - 按下按键

应用管理

• adb_install_app - 安装 APK
• adb_uninstall_app - 卸载应用
• adb_start_app - 启动应用
• adb_stop_app - 停止应用
• adb_list_apps - 列出已安装的应用

文件操作

• adb_push_file - 将文件推送到设备
• adb_pull_file - 从设备拉取文件
• adb_list_files - 列出目录中的文件

执行 shell 命令

• adb_shell - 执行 shell 命令
• adb_get_system_info - 获取系统信息
• adb_get_battery_info - 获取电池信息
• adb_get_logcat - 获取日志输出

🔧 技术细节

服务器包含以下基本安全措施：

• 阻止危险的 shell 命令
• 进行文件路径验证
• 验证设备连接
• 对输入进行清理

📚 详细文档

构建

npm run build

开发模式

npm run dev

代码检查

npm run lint

MCP

      "mcpServers": {
        "adb-mcp": {
          "type": "stdio",
          "command": "node",
          "args": [
            "/adb-mcp/dist/index.js"
          ],
          "env": {
            "ADB_DOWNLOAD_PATH": "/adb-mcp",
            "MCP_READ_PATH": "/adb-mcp"
          }
        }
      }

📄 许可证

本项目采用 MIT 许可证。