🚀 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：
clip.exe - macOS：
pbcopy - Linux：
xclip或wl-copy
- Windows：
- 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 |
adb_uninstall_app |
卸载应用程序 | -d <设备ID> -n <包名> |
adb_screen_shot |
截取屏幕截图 | -d <设备ID> |
adb_connect |
连接远程 ADB 服务器 | -h |
adb_disconnect |
断开远程 ADB 服务器连接 | -h |
🛠️ 设备管理
- 自动选择设备：如果只有一个设备连接，直接使用该设备
- 指定设备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