Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client