JinDaGe - android-adb-mcp-server MCP Details

article

README

🚀 Android ADB MCP 服务器

Android ADB MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务器，它让 AI 助手能够借助 Android 调试桥接（ADB）与 Android 设备进行交互。该服务器将 AI 功能与 Android 设备管理相连接，实现了 Android 开发和测试操作的无缝自动化。

🚀 快速开始

⚙️ 快速设置

将服务器添加到您的 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）
对于 Windows/Linux，请检查相应应用程序支持目录

配置完成后，重启您的 AI 助手以加载新的服务器配置。

📦 安装指南

📋 先决条件

ADB (Android Debug Bridge) 必须已安装并添加到系统 PATH
- 在 Windows/Linux/Ubuntu 上安装 ADB
剪贴板工具：
- Windows：clip.exe
- macOS：pbcopy
- Linux：xclip 或 wl-copy
Node.js (16.0+)

📦 其他安装方式

方法一：npm 安装

npm install -g @landicefu/android-adb-mcp-server

方法二：手动安装从源码

克隆仓库：

git clone https://github.com/landicefu/android-adb-mcp-server.git
cd android-adb-mcp-server

安装依赖并构建：

npm install
npm run build

配置直接路径：

{
  "mcpServers": {
    "android-adb": {
      "command": "node",
      "args": ["/path/to/android-adb-mcp-server/build/index.js"],
      "env": {},
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

✨ 主要特性

📸 功能

✨ 可用工具

| 工具名称 | 描述 | 参数 | |---------------------------|--------------------------------------------------------------|--------------------------| | adb_devices | 获取所有连接的 Android 设备列表 | 无 | | adb_device_info | 获取指定设备的信息 | -d <设备ID> | | adb_logcat | 查看设备日志 | -d <设备ID> | | adb_shell | 在设备上执行 shell 命令 | -d <设备ID> -c <命令> | | adb_install_apk | 安装 APK 文件 | -d <设备ID> -a <APK路径>| | adb_uninstall_app | 卸载应用程序 | -d <设备ID> -n <包名> | | adb_screen_shot | 截取屏幕截图 | -d <设备ID> | | adb_connect | 连接远程 ADB 服务器 | -h <IP地址> -p <端口> | | adb_disconnect | 断开远程 ADB 服务器连接 | -h <IP地址> |

🛠️ 设备管理

自动选择设备：如果只有一个设备连接，直接使用该设备
指定设备ID：通过参数 -d <设备ID> 指定特定设备
多设备支持：支持同时操作多个设备

📄 截图路径解析

绝对路径：/path/to/screen.png
相对路径：./screen.png
以波浪线开头的路径：~/screen.png

🔧 技术细节

🔧 故障排除

常见问题

设备未连接
- 确保设备已通过 USB 连接
- 检查设备是否允许调试
ADB 未安装
- 参考先决条件安装 ADB
权限问题
- 使用管理员权限运行命令
日志无输出
- 确保设备已连接且有日志输出

解决方法

检查设备是否正确连接：

adb devices

启动 ADB 服务：

adb start-server

📄 许可证

本项目遵循 ISC 许可证，详情请查看 LICENSE 文件。

🤝 贡献指南

欢迎贡献！请随意提交 Pull Request。

叉仓库：

git fork

创建功能分支：

git checkout -b feature/amazing-feature

提交更改：

git commit -m 'Add some amazing feature'

推送到分支：

git push origin feature/amazing-feature

提交 Pull Request

android-adb-mcp-server