Android ADB MCP Server - FindMCP.info

Overview

基本能力

产品定位

Android ADB MCP Server 主要用于 Android 设备的自动化管理和操作，特别适用于开发和测试场景。

核心功能

连接和管理多个 Android 设备
在 Android 设备上执行 shell 命令
安装和卸载应用程序
在本地系统和 Android 设备之间推送和拉取文件
启动应用程序
截屏并保存到本地或复制到剪贴板
智能设备选择（当多个设备连接时）

适用场景

Android 应用开发
自动化测试
设备管理
文件传输

工具列表

工具	描述	必需参数	可选参数
`adb_devices`	列出连接的设备	无	无
`adb_shell`	执行 shell 命令	`command`	`device_id`
`adb_install`	安装 APK 文件	`path`	`device_id`
`adb_uninstall`	卸载应用程序	`package_name`	`device_id`
`adb_list_packages`	列出已安装的包	无	`device_id`, `filter`
`adb_pull`	从设备拉取文件	`remote_path`, `local_path`	`device_id`
`adb_push`	推送文件到设备	`local_path`, `remote_path`	`device_id`
`launch_app`	启动应用程序	`package_name`	`device_id`
`take_screenshot_and_save`	截屏并保存	`output_path`	`device_id`, `format`
`take_screenshot_and_copy_to_clipboard`	截屏到剪贴板	无	`device_id`, `format`

常见问题解答

"ADB is not available" 错误
确保 ADB 已安装并在系统 PATH 中
在终端运行 adb version 验证
"No Android devices connected" 错误
检查设备是否正确连接
确保设备上启用了 USB 调试
尝试重启 ADB
"Multiple devices connected" 错误
在工具调用中指定 device_id 参数
使用 adb_devices 工具获取可用设备列表
截屏到剪贴板不工作
确保安装了平台特定的工具

使用教程

使用依赖

ADB (Android Debug Bridge) 必须安装并在系统 PATH 中
安装 ADB
验证安装：adb version
剪贴板功能要求：
macOS: osascript (内置)
Windows: PowerShell (内置)
Linux: xclip (通过 apt-get install xclip 或等效命令安装)
Node.js 16.x 或更高版本

安装教程

将服务器添加到 MCP 配置文件：

{
  "mcpServers": {
    "android-adb": {
      "command": "npx",
      "args": ["-y", "@landicefu/android-adb-mcp-server"],
      "env": {},
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

配置位置：
Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
Cline/Roo Code: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json (macOS)
配置完成后，重启 AI 助手以加载新服务器配置

调试方式

验证 ADB 安装：adb version
检查设备连接：adb devices
重启 ADB：adb kill-server 后跟 adb start-server

许可证

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