mcp-server-adb

mcp-server-adb

用于控制 Android Debug Bridge（ADB）的模型上下文协议服务

这是一个基于 TypeScript 的 MCP 服务，实现了 ADB 控制系统。它允许 AI 助手通过 ADB 命令与 Android 设备交互，提供：

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

功能

资源

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

工具

设备控制

• connect_device - 连接到指定设备
• disconnect_device - 断开与设备的连接

设备操作

• tap - 点击屏幕
• swipe - 滑动屏幕
• input_text - 输入文本
• press_key - 按下按键
• take_screenshot - 截取屏幕截图

应用管理（即将推出）

• install_app - 安装 APK
• uninstall_app - 卸载应用
• start_app - 启动应用
• stop_app - 停止应用

提示词

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

前置条件

• Node.js 16 或更高版本
• 已安装 Android Debug Bridge（ADB），且可在 PATH 中找到
• 已启用 USB 调试或网络 ADB 的 Android 设备

开发

安装依赖：

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 服务通过 stdio 通信，调试可能颇具挑战。我们建议使用 MCP Inspector，它可作为包脚本使用：

npm run inspector

Inspector 会提供一个 URL，供你在浏览器中访问调试工具。

设备设置

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

   • 前往“设置”>“关于手机”
   • 点按“版本号” 7 次以启用开发者选项
   • 前往“设置”>“开发者选项”
   • 启用“USB 调试”

2. 进行网络调试：

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

许可证

MIT