AI导哈

ADB控制服务

一个基于TypeScript的MCP服务器，实现通过ADB命令控制Android设备的功能，适用于AI助手与Android设备的交互。

  • by yava555
  • JavaScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 yava555/mcp-server-adb

使用说明

mcp服务器adb

用于Android调试桥（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调试桥（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检查员，可作为包脚本使用：

npm run inspector

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

设备设置

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

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

  2. 网络调试：

    • 首先通过USB连接设备
    • 在开发人员选项中启用“无线调试”
    • 使用 connect_device 带有设备IP地址的工具

许可证

麻省理工学院

相关 MCP