DroidLume Agent Control

English · 简体中文

DroidLume용 npm 배포 CLI 및 MCP 서버와 표준 AI 에이전트 스킬입니다.

DroidLume Agent Control을 사용하면 DroidLume이 관리하는 로컬 Android 가상 기기를 Codex, Claude Code, Cursor, Gemini 및 기타 AI 에이전트가 제어할 수 있습니다. 취약한 화면 좌표 자동화에 의존하지 않고 구조화된 CLI, 로컬 MCP 서버, macOS App Intents, 개방형 Agent Skill을 결합합니다.

제공 기능

• Android 기기 생성, 복제, 구성, 시작, 중지, 다시 시작, 복구, 표시, 삭제

• 스트리밍 샌드박스 업로드를 통한 APK 파일 설치

• Android 앱 나열, 실행, 중지, 제거

• 텍스트 입력, 좌표 탭, 스와이프, Android 키 이벤트 전송

• Android 스크린샷을 PNG 또는 네이티브 MCP 이미지 콘텐츠로 캡처

• 편집된 DroidLume 진단 정보 내보내기

• 안정적인 기기 ID, 형식화된 JSON, 명령 스키마, 시간 초과, 구조화된 오류 반환

Related MCP server: DeepADB

요구 사항

• 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개의 형식화된 도구, 3개의 리소스, 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 처리;

• DroidLume 샌드박스로의 스트리밍 APK 업로드;

• 구조화된 명령 검색 및 오류;

• 네이티브 앱, CLI, MCP, Shortcuts이 공유하는 단일 제어 평면.

FAQ

Android 에뮬레이터인가요?

DroidLume은 Android 가상 기기 애플리케이션입니다. 이 저장소는 이를 자동화하는 데 사용되는 npm CLI/MCP 구현과 Agent Skill을 제공하며, 두 번째 macOS 애플리케이션이 아닙니다.

공개 인터페이스로 원시 ADB를 사용하나요?

아니요. AI 클라이언트는 버전이 지정된 DroidLume 제어 API를 호출합니다. 호스트 앱은 자체 프라이빗 ADB 네임스페이스와 관리 기기 수명 주기를 소유합니다.

어떤 AI 도구를 지원하나요?

Agent Skill은 공개 SKILL.md 형식을 따릅니다. CLI는 모든 셸에서 작동하며, MCP 서버는 Codex, Claude Code, Cursor, Gemini 도구를 포함한 MCP 지원 클라이언트에서 작동합니다.

도구가 로컬인가요?

네. DroidLume 호스트 제어 엔드포인트는 127.0.0.1에서 수신 대기하며, droidlume-mcp는 로컬 stdio 전송을 사용합니다.

링크

• DroidLume 공식 웹사이트

• Agent Control 문서

• npm 패키지

• 지원

라이선스

이 저장소의 Agent Skill과 문서는 MIT 라이선스에 따라 제공됩니다. DroidLume 애플리케이션 바이너리와 상표는 각 제품 약관의 적용을 받습니다.