AI导哈

ADB模型上下文协议服务

MCP-ADB是一个为AI代理设计的服务器，通过Android Debug Bridge (ADB)实现与Android设备的交互和控制，提供设备管理、UI自动化和专用命令执行功能。

  • by tiendung2k03
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 tiendung2k03/mcp-adb

使用说明

MCP-ADB:Android调试桥的模型上下文协议服务器

MCP-ADB 是一个 模型上下文协议（MCP）服务器 旨在允许人工智能代理（如Manus AI）通过Android设备进行交互和控制 **安卓调试桥（ADB）**该服务器将复杂的ADB命令转换为结构化工具，使大型语言模型（LLM）易于使用，以自动化Android设备上的任务。

目的

该项目的主要目的是提供一致和安全的编程接口（API），以便在Android设备上执行以下操作：

  1. 基本控制列出设备，执行shell命令。
  2. **用户界面自动化（UI）**屏幕截图，检查UI（XML）结构。
  3. **执行特殊命令。**使用TOML预定义的工具执行特定任务，如打开/关闭Wi-Fi、调整音量等。

主要特点

功能124描述124相应的MCP工具🙂 | :--- | :--- | :--- | | 设备管理 列出正在连接的Android设备。是啊。 adb_devices | | 执行shell 执行设备上的任何shell命令。是啊。 adb_shell | | 检查UI 捕获并返回当前UI结构为XML。是啊。 inspect_ui | | 屏幕截图 截取屏幕截图并将其返回为Base64。是啊。 screenshot | | 动态工具 根据文件夹中的TOML配置文件自动注册工具 commands/android^（TOML文件名）^

安装和启动

要求

  • Node.js （版本18及以上）
  • pnpm （npm/yarn）
  • 安卓调试桥（ADB）:
    • 在Linux/macOS上：通过包管理器安装（例如： sudo apt install android-tools-adb).
    • 顶部 Termux（安卓系统）：通过安装 pkg install android-tools.

安装步骤

  1. 克隆存储库：

    git clone https://github.com/tiendung2k03/mcp-adb.git
cd mcp-adb

  2. 安装依赖项：

    pnpm install

  3. 构建项目：

    pnpm run build

Termux的个人指南

要在Termux上运行MCP-ADB并控制设备本身或其他设备，请执行以下操作：

  1. 安装Node.js和ADB：

    pkg update
pkg install nodejs-lts android-tools

  2. 无线调试：

    • 进来。 开发人员选项 在电话里。
    • 启用 无线调试.
    • 将亚洲开发银行与自身联系起来： adb connect localhost:PORT （使用Wireless Debugging中显示的端口）

  3. 运行服务器：

    node dist/index.js

  4. 启动MCP服务器： 此服务器设计用于运行 **标准输入/输出（stdio）**这是由人工智能代理（如Manus AI）启动的MCP服务器的标准通信方法。

    pnpm start

    运行时，服务器将监听来自stdin的MCP请求，并通过stdout发送响应。

连接和使用

您可以连接 MCP-ADB 两种方式：通过 标准输入/输出（stdio） 或通过 HTTP-SSE（URL）.

方法1：通过标准I/O连接（推荐用于本地AI代理）

在应用程序中使用以下JSON配置（Manus AI、Claude Desktop、Cursor）：

{
  "mcpServers": {
    "mcp-adb": {
      "command": "node",
      "args": [
        "/đường/dẫn/tới/mcp-adb/dist/index.js"
      ],
      "env": {
        "PATH": "/usr/local/bin:/usr/bin:/bin:/đường/dẫn/tới/adb"
      }
    }
  }
}

方法2：通过HTTP SSE连接（使用URL）

如果您想将服务器作为web服务运行并通过URL连接：

  1. 在SSE模式下启动服务器：

    pnpm run start:sse

    服务器将运行。 http://localhost:3000.您可以使用环境变量更改端口 PORT=4000.

  2. 连接地址（Endpoint）：

    • 本地（同Wi-Fi网络）： http://<IP_ĐIỆN_THOẠI>:3000/sse
    • 远程（不同网络）： 查看指南 远程访问（Remote Access） 使用Cloudflare Tunnel或LocalTunnel。

  3. JSON配置（如果需要）：

    {
  "mcpServers": {
    "mcp-adb": {
      "url": "http://localhost:3000/sse"
    }
  }
}

如何在Manus AI上设置

  1. 进来。 设置 -> 集成 -> 自定义MCP服务器.
  2. 选择 添加服务器 或 导入 JSON.
  3. 粘贴上面的JSON代码片段（更改了实际路径）。
  4. Manus将识别以下工具： adb_devices, screenshot, inspect_ui 超过150种其他控制工具。

如何在Claude桌面上安装

  1. 打开文件 claude_desktop_config.json （在 %APPDATA%\Claude 在Windows或 ~/Library/Application Support/Claude 在macOS上）。
  2. 添加项目 mcp-adb 部分 mcpServers.
  3. 重新启动Claude。

项目结构

mcp-adb/
├── commands/
│   └── android/
│       ├── abi.toml
│       ├── airplane_on.toml
│       └── ... (các công cụ ADB chuyên biệt)
├── dist/
│   └── index.js (File đã build)
├── src/
│   └── index.ts (Mã nguồn chính của MCP Server)
├── utils/ (Các script Python hỗ trợ)
├── package.json
├── tsconfig.json
└── README.md

主要源代码在 src/index.ts定义MCP工具和逻辑以执行相应的ADB命令。专用工具通过TOML文件定义，无需更改TypeScript源代码即可轻松扩展。

相关 MCP