返回 MCP 目录
public公开dns本地运行

adb-mcp

一个通过WiFi连接Android设备并使用ADB工具进行截图的MCP服务器

article

README

🚀 ADB截图MCP服务器

这是一个模型上下文协议(MCP)服务器,它提供了ADB工具,可通过WiFi连接到安卓设备并进行截图操作。

✨ 主要特性

  • WiFi连接:使用ADB通过WiFi连接到安卓设备。
  • 截图功能:对已连接的设备进行截图。
  • 设备管理:列出设备、获取设备信息并断开连接。
  • 远程访问:非常适合在同一网络中访问设备。

📦 安装指南

npm install
npm run build

💻 使用示例

基础用法

在安卓设备上启用WiFi ADB:

  1. 首先通过USB连接设备。
  2. 运行:adb tcpip 5555
  3. 断开USB连接并查找设备的IP地址。
  4. 使用 adb_connect_wifi 工具并传入IP地址。

高级用法

可用工具

  1. adb_connect_wifi:通过WiFi连接到设备

    • ip_address:设备IP地址(必需)
    • port:端口号(默认:5555)
  2. adb_screenshot:进行截图

    • output_path:保存位置(默认:screenshot.png)
    • device_id:特定设备(可选)
  3. adb_list_devices:列出所有已连接的设备

  4. adb_disconnect:断开与WiFi设备的连接

    • ip_address:设备IP地址(必需)
    • port:端口号(默认:5555)
  5. adb_device_info:获取设备信息

    • device_id:特定设备(可选)

运行服务器

npm start

示例工作流程

  1. 启用WiFi ADB:adb tcpip 5555
  2. 连接:使用 adb_connect_wifi 并传入设备IP。
  3. 截图:使用 adb_screenshot
  4. 断开连接:完成后使用 adb_disconnect
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端