Android Adb MCP Server

🚀 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

方法二：手动安装从源码

1. 克隆仓库：

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

2. 安装依赖并构建：

npm install
npm run build

3. 配置直接路径：

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

✨ 主要特性

📸 功能

✨ 可用工具

🛠️ 设备管理

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

📄 截图路径解析

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

🔧 技术细节

🔧 故障排除

常见问题

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

解决方法

1. 检查设备是否正确连接：

adb devices

2. 启动 ADB 服务：

adb start-server

📄 许可证

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

🤝 贡献指南

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

1. 叉仓库：

git fork

2. 创建功能分支：

git checkout -b feature/amazing-feature

3. 提交更改：

git commit -m 'Add some amazing feature'

4. 推送到分支：

git push origin feature/amazing-feature

5. 提交 Pull Request