mcp-server-adb

🚀 mcp-server-adb 服务端

mcp-server-adb 是一个基于 TypeScript 的 MCP 服务器，专为 Android 调试桥接（ADB）控制而设计。它为 AI 助手提供了与安卓设备交互的能力，具备设备发现、控制、应用管理以及分析诊断等功能，极大地提升了安卓设备调试与管理的效率。

🚀 快速开始

要使用 mcp-server-adb 服务端，你需要满足以下先决条件：

• Node.js 16 或更高版本。
• Android 调试桥接（ADB）已安装并添加到 PATH 环境变量中。
• 启用 USB 调试的安卓设备，或支持网络 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：分析当前屏幕内容。

📦 安装指南

开发环境安装

安装依赖：

npm install

构建服务器：

npm run build

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

npm run watch

在 Claude Desktop 中使用

要在 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 地址一起使用。