DroidLume Agent Control

English · 简体中文

通过 npm 分发的 CLI 和 MCP 服务器，外加一个面向 DroidLume 的标准 AI Agent Skill。

DroidLume Agent Control 让 Codex、Claude Code、Cursor、Gemini 以及其他 AI 代理能够控制由 DroidLume 管理的本地 Android 虚拟设备。它结合了结构化 CLI、本地 MCP 服务器、macOS App Intents 和开放的 Agent Skill，无需依赖脆弱的屏幕坐标自动化。

它能做什么

• 创建、克隆、配置、启动、停止、重启、修复、查看和删除 Android 设备

• 通过流式沙箱上传安装 APK 文件

• 列出、启动、停止和卸载 Android 应用

• 输入文本、点击坐标、滑动和发送 Android 按键事件

• 以 PNG 或原生 MCP 图像内容捕获 Android 截图

• 导出经过脱敏处理的 DroidLume 诊断信息

• 返回稳定的设备 ID、类型化 JSON、命令模式、超时和结构化错误

Related MCP server: adb-mcp

系统要求

• Apple 芯片 Mac

• macOS 14 或更高版本

• DroidLume 1.1 或更高版本

• Node.js 20 或更高版本

安装

从 npm 安装 CLI 和 MCP 服务器，然后为你的代理安装 Skill：

npm install --global droidlume-agent-control
droidlume agent install codex

或者运行维护好的安装程序，它会执行相同的两个步骤：

curl -fsSL https://raw.githubusercontent.com/tageecc/droidlume-agent-control/main/install.sh | zsh -s -- codex

目标：

all | codex | claude | cursor | agents

验证安装：

droidlume version
droidlume status --format pretty
droidlume device list --format pretty

MCP 配置

生成 MCP 配置片段：

droidlume agent config

无需手动下载 ZIP 的推荐配置：

{
  "mcpServers": {
    "droidlume": {
      "command": "npx",
      "args": ["-y", "droidlume-agent-control", "mcp"]
    }
  }
}

MCP 服务器使用 stdio，暴露了 23 个类型化工具、三个资源和 Android 应用检查提示。截图以原生 image/png MCP 内容返回。

CLI 示例

启动设备并打开其窗口：

droidlume device start DEVICE_ID --show --timeout 180

安装并启动 APK：

droidlume app install DEVICE_ID /absolute/path/application.apk --timeout 300
droidlume app launch DEVICE_ID com.example.app

检查 Android 屏幕：

droidlume device screenshot DEVICE_ID --output screen.png
droidlume input tap DEVICE_ID 540 1200
droidlume device screenshot DEVICE_ID --output screen-after.png

在自动化之前阅读机器契约：

droidlume schema
droidlume schema device start

查看完整的命令目录、MCP 指南、状态与安全规则和错误参考。

架构

Codex / Claude / Gemini / Cursor / CI
                    │
        Agent Skill / npm MCP / npm CLI
                    │
       DroidLume Control API v1.0
          http://127.0.0.1:55777
                    │
          DroidLume RuntimeController
                    │
             Managed Android devices

公共 CLI 和 MCP 服务器通过回环与 DroidLume 宿主应用通信。设备生命周期、应用安装、截图、输入和诊断仍然通过原生 macOS 界面使用的同一个 RuntimeController 运行。

为什么选择 DroidLume Agent Control

通用的 Android 自动化通常暴露原始 ADB 序列号或依赖截图坐标。DroidLume 取而代之提供产品级的控制契约：

• 稳定的设备 UUID，而非临时的模拟器序列号；

• 感知生命周期的启动、停止、重启、修复和 Quick Boot 处理；

• 将 APK 流式上传到 DroidLume 沙箱；

• 结构化的命令发现和错误；

• 由原生应用、CLI、MCP 和 Shortcuts 共享的单一控制平面。

常见问题

这是 Android 模拟器吗？

DroidLume 是 Android 虚拟设备应用。本仓库提供用于自动化它的 npm CLI/MCP 实现和 Agent Skill；它不是另一个 macOS 应用。

它使用原始 ADB 作为公共接口吗？

不。AI 客户端调用带版本号的 DroidLume 控制 API。宿主应用拥有其私有 ADB 命名空间和受管设备生命周期。

支持哪些 AI 工具？

Agent Skill 遵循开放的 SKILL.md 格式。CLI 可在任何 shell 中工作，MCP 服务器可与支持 MCP 的客户端配合使用，包括 Codex、Claude Code、Cursor 和 Gemini 工具。

这个工具是本地运行的吗？

是的。DroidLume 宿主控制端点监听 127.0.0.1，droidlume-mcp 使用本地 stdio 传输。

链接

• DroidLume 官方网站

• Agent Control 文档

• npm 包

• 支持

许可证

本仓库中的 Agent Skill 和文档在 MIT 许可证 下提供。DroidLume 应用程序二进制文件和商标仍受其各自产品条款的约束。