mcp-server-adb 服务端

一个基于 TypeScript 的 MCP 服务器，用于 Android 调试桥接（ADB）控制。该服务器允许 AI 助手通过 ADB 命令与安卓设备交互，提供以下功能：

• 设备发现和信息资源
• 设备控制和应用管理工具
• 设备分析和诊断提示

特性

资源

• 列出连接的设备：device://list
• 获取设备信息：device://{serial}/info
• 查看已安装包：device://{serial}/packages
• 截取屏幕截图：device://{serial}/screenshot

工具

1. 设备控制工具

   • connect_device：通过网络连接到设备
   • disconnect_device：断开网络连接的设备

2. 应用管理工具

   • install_app：安装 APK 文件
   • uninstall_app：卸载已安装的应用程序
   • start_app：启动应用程序
   • stop_app：强制停止应用程序

3. 设备输入工具

   • tap：模拟屏幕点击
   • swipe：模拟屏幕滑动
   • input_text：输入文本
   • press_key：模拟按键按压
   • take_screenshot：截取屏幕

提示

• analyze_device：分析设备状态和规格
• analyze_app_list：分析已安装的应用程序
• analyze_screen：分析当前屏幕内容

先决条件

• Node.js 16 或更高版本
• Android 调试桥接（ADB）已安装并添加到 PATH 环境变量中
• 启用 USB 调试的安卓设备，或支持网络 ADB 的设备

开发

安装依赖：

npm install

构建服务器：

npm run build

带有自动重建功能的开发环境：

npm run watch

安装

要在 Claude Desktop 中使用，请添加以下服务器配置：

在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-adb": {
      "command": "/path/to/mcp-server-adb/build/index.js"
    }
  }
}

调试

由于 MCP 服务器通过标准输入输出进行通信，调试可能具有挑战性。我们推荐使用 MCP 检查器，该检查器作为包脚本提供：

npm run inspector

检查器将提供一个 URL，用于在浏览器中访问调试工具。

设备设置

1. 在安卓设备上启用 USB 调试：

   • 进入设置 > 关于手机
   • 点击“构建编号”七次以启用开发者选项
   • 进入设置 > 开发者选项
   • 启用“USB 调试”

2. 对于网络调试：

   • 先通过 USB 连接设备
   • 在开发者选项中启用“无线调试”
   • 使用 connect_device 工具与设备的 IP 地址一起使用