Skip to main content
Glama
abewartech

webadb-agent

by abewartech
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

webadb-agent 📱🌐🤖

HP Android kamu — di web, bisa dikendalikan AI agent juga.

Satu service ringan yang bikin HP Android fisik (atau emulator di Docker) bisa diakses dari browser dan dari AI agent, kayak emulator tapi devicenya punya kamu sendiri.

[HP fisik] ──USB/WiFi──┐
                       ├─► adb server ─► webadb-agent bridge ─► Browser (layar live, klik=tap)
[Emulator Docker] ─────┘                          ├─► REST API  (untuk agent remote)
                                                  └─► MCP server (untuk agent lokal)

Gabungan 3 project

Project

Yang diambil

yume-chan/ya-webadb (Tango)

ADB client murni TypeScript (@yume-chan/adb) — tanpa re-implementasi protokol

callstack/agent-device

Pola remote proxy via tunnel + loop agent inspect → act → verify + MCP server

google/android-emulator-container-scripts

Emulator Android di Docker sebagai backend alternatif HP fisik

Related MCP server: scrcpy-mcp

Quick start (HP fisik)

# 1. Di PC: install platform-tools, colok HP, aktifkan USB debugging
adb start-server && adb devices

# 2. Jalankan bridge
cd packages/bridge && npm install && npm run build
node dist/index.js bridge --port 8080
# → catat bearer token yang tercetak

# …ATAU via Docker (lihat docs/DOCKER.md):
cp .env.example .env   # isi WEBADB_TOKEN
docker compose up -d --build

# 3. Buka http://localhost:8080, masukkan token → layar HP live di web,
#    klik = tap, drag = swipe. Ada juga terminal ADB shell.

Quick start (emulator Docker, tanpa HP)

Butuh Linux + KVM + Docker. Lihat docs/EMULATOR.md.

docker compose -f docker/docker-compose.emulator.yml up -d
adb connect localhost:5555
node packages/bridge/dist/index.js bridge --serial localhost:5555

Untuk AI agent

Remote (tunnel, pola ala agent-device proxy) — lihat docs/REMOTE-ACCESS.md:

cloudflared tunnel --url http://127.0.0.1:8080
curl -H "Authorization: Bearer $TOKEN" $TUNNEL_URL/api/screenshot -o s.png

Lokal (MCP stdio) — tambah ke config MCP client:

{ "mcpServers": { "webadb-agent": {
  "command": "node", "args": ["/path/to/packages/bridge/dist/index.js", "mcp"] } } }

Tools: screenshot, tap, swipe, key, type_text, shell, open_app, device_info. Prompt siap pakai: examples/agent-prompt.md. Referensi REST: docs/AGENT-API.md. Mau pakai framework agent (OpenManus/OpenHands/agent-zero/Hermes) sebagai driver? Lihat docs/AGENT-FRAMEWORKS.md. Ada juga skill siap pakai skills/phone-operator/SKILL.md (format agentskills.io, untuk Claude Code/Hermes/dll).

Struktur

packages/bridge/src/  → adb.ts (lapisan ADB) · server.ts (web UI + REST + WS)
                        mcp.ts (MCP stdio) · index.ts (CLI)
packages/web/         → UI web tanpa build step
docs/                 → ARCHITECTURE.md · AGENT-API.md · REMOTE-ACCESS.md · EMULATOR.md
                       AGENT-FRAMEWORKS.md (OpenManus/OpenHands/agent-zero/Hermes) · DOCKER.md
skills/phone-operator/  → SKILL.md (agentskills.io, untuk Claude Code/Hermes)
docker/               → compose emulator + Dockerfile bridge
examples/             → agent-prompt.md

Roadmap

  • scrcpy/H.264 streaming via @yume-chan/scrcpy (ganti screencap polling)

  • Mode WebUSB langsung di browser (tanpa bridge) via @yume-chan/adb-daemon-webusb

  • File manager di web UI · [ ] multi-device · [ ] rekam layar

Lisensi

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • ADB MCP Server

    LLL-404
    F
    license
    A
    quality
    D
    maintenance
    A MCP server that enables AI assistants to control Android devices via ADB, supporting device info, screen control, input simulation, app management, shell execution, file transfer, and UI parsing.
    20
    -

  • scrcpy-mcp

    JuanCF
    A
    license
    A
    quality
    A
    maintenance
    MCP server that gives AI agents full vision and control over Android devices via ADB and scrcpy. Supports screenshots, input, apps, UI automation, shell, files, and clipboard.
    38
    154 npm
    122
    MIT

  • androir-mcp

    benasbarciauskas
    A
    license
    B
    quality
    D
    maintenance
    An MCP server that allows AI agents to drive real Android devices via adb, capturing screenshots, reading the live UI tree, and performing actions like tap, swipe, and type.
    13
    5 npm
    1
    Apache 2.0