跳到正文
开源 Skill · npm · MCP

用 AI 操作
DroidLume 设备

Agent Control 把 DroidLume 接到 Codex、Claude Code、Cursor 和 Gemini。AI 可以开关设备、安装应用、点击和输入,还能截图检查操作结果。

npm install -g droidlume-agent-control
工作方式

Agent 通过本机接口控制 DroidLume

Skill 告诉 AI 该用哪个命令,CLI 或 MCP 负责发送请求,DroidLume 再执行设备操作。整个控制接口只监听本机地址。

01Agent Skill告诉 AI 怎么使用工具
02CLI / MCP把命令发给 DroidLume
03本机接口127.0.0.1:55777
04Android 设备执行操作并返回结果
27 个 MCP 工具

能做哪些事

常用的设备、应用和输入操作都已经做成 MCP 工具。每次调用都会返回明确的结果;需要看界面时,AI 可以直接读取截图。

管理设备创建、启动、停止、查看状态
管理应用安装、打开、关闭
操作界面点击、滑动、输入、按键
检查结果截图、设备快照、导出诊断信息
mcp-config.json
{
  "mcpServers": {
    "droidlume": {
      "command": "npx",
      "args": ["-y",
        "droidlume-agent-control",
        "mcp"]
    }
  }
}
几个细节

给自动化用,也方便排查问题

01

设备 ID 不会乱

设备改名或重新启动后,AI 仍然能找到原来的设备。

02

直接安装本地 APK

客户端读取 APK 并传给 DroidLume,不需要额外搭文件服务。

03

可以看截图

操作完成后让 AI 看一眼界面,比只判断命令返回值更可靠。

04

Skill 是开源的

使用标准 SKILL.md,可以按自己的工作流修改。

常见问题

安装前可以先看这里

还要从 GitHub 下载 ZIP 吗?

不用。CLI、MCP Server 和 Skill 都在同一个 npm 包里。

Agent Control 也是模拟器吗?

它只是控制工具。Android 设备仍由 DroidLume Mac 应用运行。

代码开源吗?

Skill、CLI、MCP Server 和文档都使用 MIT License。

控制命令会发到外网吗?

控制接口只监听 127.0.0.1,MCP 通过本机 stdio 通信。

当前版本 1.2.0

安装 Agent Control

先装 npm 包,再运行 Skill 安装命令。

打开 npm →