DeepADB
DeepADB
MCP-Server (Model Context Protocol) für KI-Agenten, die Android-Geräte über ADB inspizieren, steuern, testen und diagnostizieren müssen – oder direkt auf dem Gerät über Termux.
204 Tools, 5 Ressourcen und 4 Prompts in 45 Modulen – von UI-Automatisierung und Anwendungsverwaltung bis hin zu Protokollen, Netzwerkerfassung, Basisband, Firmware, Sicherheit und Hardware-Diagnose.
Get started
DeepADB läuft als lokaler MCP-Server. Es verwendet standardmäßig ADB und wechselt automatisch zur direkten Ausführung, wenn es Termux auf einem Android-Gerät erkennt.
git clone https://github.com/fullread/DeepADB.git
cd DeepADB
npm ci
npm run build
npm startFügen Sie build/index.js zu Ihrer MCP-Client-Konfiguration hinzu und beginnen Sie dann mit diesen Workflows:
Ziel | Beginnen Sie mit |
Toolchain und verbundenes Gerät bestätigen |
|
Aktuelle Android-Benutzeroberfläche untersuchen |
|
Gerät oder App diagnostizieren |
|
Für eine geführte lokale Verbindung siehe Claude Code Configuration. Lesen Sie SECURITY.md, bevor Sie HTTP-, WebSocket- oder GraphQL-Transports über Loopback hinaus freigeben.
Related MCP server: android-mcp-server
Architecture
┌──────────────────────────────────────────────────┐
│ MCP Client │
│ (Claude Code / claude.ai) │
└──────────────────────┬───────────────────────────┘
│ stdio (JSON-RPC) or HTTP/SSE or WebSocket
┌──────────────────────▼───────────────────────────┐
│ DeepADB Server │
│ │
│ ┌─────────────────────────────────────────────┐ │
│ │ Tool Modules (45) │ │
│ │ device │ shell │ packages │ files │ logs │ │
│ │ diagnostics │ ui │ build │ health │ │
│ │ wireless │ control │ logcat-watch │ │
│ │ forwarding │ screen-record │ emulator │ │
│ │ testing │ multi-device │ snapshot │ │
│ │ network-capture │ ci │ plugins │ baseband │ │
│ │ accessibility │ regression │ │
│ │ device-farm │ registry │ at-commands │ │
│ │ screenshot-diff │ workflow │ sensors │ │
│ │ split-apk │ mirroring │ test-gen │ │
│ │ ota-monitor │ ril-intercept │ │
│ │ device-profiles │ firmware-analysis │ │
│ │ workflow-market │ selinux-audit │ │
│ │ thermal-power │ network-discovery │ │
│ │ input-gestures │ wireless-firmware │ │
│ ├─────────────────────────────────────────────┤ │
│ │ Resources (5) │ Prompts (4) │ │
│ └───────────────────┬─────────────────────────┘ │
│ │ │
│ ┌───────────────────▼─────────────────────────┐ │
│ │ ToolContext (unified DI) │ │
│ │ server │ bridge │ deviceManager │ │
│ │ logger │ security │ config │ │
│ └───────────────────┬─────────────────────────┘ │
│ │ │
│ ┌───────────────────▼─────────────────────────┐ │
│ │ Middleware Layer │ │
│ │ OutputProcessor │ SecurityMiddleware │ │
│ │ InputSanitizer │ Logger (stderr-safe) │ │
│ └───────────────────┬─────────────────────────┘ │
│ │ │
│ ┌───────────────────▼─────────────────────────┐ │
│ │ Bridge Layer (auto-detect) │ │
│ │ │ │
│ │ ┌─────────────┐ ┌────────────────────┐ │ │
│ │ │ ADB Bridge │ OR │ Local Bridge │ │ │
│ │ │ (PC mode) │ │ (on-device mode) │ │ │
│ │ │ via adb.exe │ │ via sh/su direct │ │ │
│ │ └──────┬───────┘ └────────┬───────────┘ │ │
│ │ │ │ │ │
│ │ Retry │ Timeout │ Cache │ Serial routing │ │
│ └─────────┼─────────────────────┼─────────────┘ │
└────────────┼─────────────────────┼───────────────┘
│ │
┌───────▼───────┐ ┌───────▼───────┐
│ ADB Binary │ │ sh / su │
│ (USB/WiFi) │ │ (local) │
└───────┬───────┘ └───────┬───────┘
│ │
┌─────▼────────────────────▼─────┐
│ Android Device │
└────────────────────────────────┘Dual-Mode Architecture
DeepADB arbeitet in zwei Modi, die beim Start automatisch erkannt werden:
ADB Mode (default) — PC-side bridge
AI Agent (PC) ←→ MCP ←→ DeepADB (PC) ←→ ADB (USB) ←→ Android DeviceStandardmodus: DeepADB läuft auf einem PC/Mac/Linux-Host und kommuniziert über USB mit dem Gerät über ADB. Alle 204 Tools arbeiten über die ADB-Brücke mit automatischem Wiederholungsversuch bei vorübergehenden Fehlern.
On-Device Mode — direct local execution
AI Agent (Termux) ←→ MCP (stdio/HTTP) ←→ DeepADB (Termux) ←→ sh/su (local)Wenn DeepADB direkt auf dem Android-Gerät läuft (z. B. in Termux), erkennt es die Umgebung automatisch und wechselt zu LocalBridge. Befehle werden direkt über sh/su ausgeführt – kein ADB-Server, kein USB, kein Serialisierungs-Overhead. Alle 204 Tools funktionieren identisch, mit deutlich geringerer Latenz.
Auf Hardware validiert (Pixel 6a, Android 16, Termux + Magisk + QEMU 10.2.1) über eine Vier-Zellen-Testmatrix – Host (ADB) und On-Device (LocalBridge), jeweils mit und ohne Geräte-PIN – mit 0 Fehlern in jeder Zelle. Die vollständige Suite umfasst 577 Tests in der Host/ADB-Konfiguration und 613 auf dem Gerät; der Unterschied sind die QEMU-Virtualisierungs- und Alpine-VM-Boot-Suiten, die nur auf dem Gerät ausgeführt werden:
ADB-Modus, ohne PIN: 556 bestanden / 0 fehlgeschlagen / 21 übersprungen (577 gesamt). Übersprungen: 5 QEMU (nur auf dem Gerät), 7 gracefulKill-Unit-Tests (erfordern POSIX-Signale, auf dem Windows-Host übersprungen), 3 tcpdump-Sanitisierung (tcpdump ist nur mit Root verfügbar und über eine Nicht-Root-ADB-Shell nicht erreichbar), 2 Host-Shell-Roundtrips (erfordern eine POSIX-/bin/sh), 4 Screen-State (erfordern DA_TEST_PIN).
ADB-Modus, mit PIN: 560 bestanden / 0 fehlgeschlagen / 17 übersprungen (577 gesamt). Die 4 Screen-State-Tests entsperren und laufen.
On-Device-Modus, ohne PIN: 606 bestanden / 0 fehlgeschlagen / 7 übersprungen (613 gesamt). Alle QEMU-Tests laufen, einschließlich Alpine-Linux-VM-Boot mit KVM-Beschleunigung, big.LITTLE-CPU-Topologie-Erkennung, Fehlerbehandlung bei Gast-ADB-Konnektivität und sauberem VM-Herunterfahren; die tcpdump- und gracefulKill-Suiten laufen ebenfalls hier (Root + POSIX). Übersprungen: 3 QEMU-Einrichtungsschritte, die nichts tun, wenn Alpine-Kernel/initrd/Disk bereits zwischengespeichert sind, 4 Screen-State (erfordern PIN).
On-Device-Modus, mit PIN: 610 bestanden / 0 fehlgeschlagen / 3 übersprungen (613 gesamt). Jeder durch die Umgebung aktivierte Test läuft; die 3 Überspringungen sind die zwischengespeicherten VM-Einrichtungsschritte.
Rechteerweiterung: Im ADB-Modus laufen alle Shell-Befehle als uid=2000 (der shell-Benutzer), der Systemberechtigungen hat. In Termux laufen Befehle als normaler App-Benutzer. LocalBridge erhöht privilegierte Befehle automatisch über su, wenn Root (Magisk) verfügbar ist:
Befehls-Allowlist: 16 Systembefehle (
settings,dumpsys,am,input,screencap,screenrecord,uiautomator,app_process,getenforce,setenforce,cmd,pm,wm,svc,ip,ifconfig) werden übersu -cgeleitet, um das Verhalten des ADB-Modus zu erreichen.Pfadbasierte Erweiterung: Befehle, die auf
/sdcard,/storageoder/system/-Pfade verweisen, werden erhöht, um die Android-Scoped-Storage-Einschränkungen zu umgehen.Root-Erkennung: Wird nach einer einzelnen
su -c id-Sonde bei der ersten Verwendung zwischengespeichert. Sanfte Degradierung, wenn Root nicht verfügbar ist.Die Erweiterungs-Allowlist ist eingefroren (
ReadonlySet+Object.freeze) – nicht über Umgebungsvariablen oder die Laufzeit-API konfigurierbar.
Automatische Erkennung: Prüft auf /system/build.prop (auf allen Android-Geräten vorhanden, nie auf Hosts). Überschreiben mit DA_LOCAL=true oder DA_LOCAL=false.
On-Device-Einrichtung (Termux):
pkg install nodejs-lts git
git clone <deepadb-repo> && cd deepadb
npm install && npm run build
npm start # stdio — for local AI agents (Claude Code, OpenCode)
DA_HTTP_PORT=3000 npm start # HTTP/SSE — for remote AI access over WiFiClaude Code Configuration
{
"mcpServers": {
"deepadb": {
"command": "node",
"args": ["/path/to/DeepADB/build/index.js"]
}
}
}Available Tools (204)
Beginnen Sie mit dem Funktionsbereich, der zu Ihrer Aufgabe passt; die vollständige Referenz finden Sie weiter unten.
Complete tool reference
Health (1 tool)
adb_health_check– Umfassende Toolchain-Validierung: ADB-Binärdatei, Server, Geräteverbindung, Autorisierung, Root-Zugriff und Schreibbarkeit des Speichers
Device (3 tools)
adb_devices– Alle verbundenen Geräte mit Status, Modell und Produktinformationen auflistenadb_device_info– Detaillierte Geräteeigenschaften (Modell, OS, SDK, Build, Sicherheitspatch, ABI)adb_getprop– Eine bestimmte Systemeigenschaft lesen oder alle Eigenschaften ausgeben
Shell (2 tools)
adb_shell– Beliebige Shell-Befehle mit konfigurierbarem Timeout ausführen (sicherheitsgeprüft)adb_root_shell– Befehle als Root über su ausführen (erfordert gerootetes Gerät, sicherheitsgeprüft)
Packages (12 tools)
adb_install– APK mit Ersetzen/Downgrade-Optionen installierenadb_uninstall– Paket mit optionaler Datenaufbewahrung entfernenadb_list_packages– Pakete nach Name oder Typ gefiltert auflisten (alle/System/Drittanbieter)adb_package_info– Detaillierte Paketinformationen (Version, Berechtigungen, Pfade)adb_clear_data– Alle App-Daten und den Cache löschenadb_grant_permission– Eine Laufzeitberechtigung für ein Paket erteilenadb_revoke_permission– Eine Laufzeitberechtigung von einem Paket entziehen (Berechtigungsstatus für Tests von Verweigerungsabläufen zurücksetzen)adb_list_permissions– Alle deklarierten und erteilten Berechtigungen für ein Paket auflisten, filterbar nach erteilt/verweigertadb_force_stop– Eine App sofort erzwingen stoppenadb_start_app– Eine App anhand des Paketnamens starten (löst Launcher-Aktivität auf)adb_restart_app– Erzwingen stoppen und dann in einem Aufruf neu starten (konfigurierbare Verzögerung)adb_resolve_intents– Registrierte Aktivitäten, Dienste und Empfänger mit Intent-Filtern entdecken
Files (18 tools)
adb_push– Lokale Datei auf das Gerät übertragen (hart blockierte Kernel-Pfade, Dateisystemtyp-Bewusstsein, Speicherberichterstattung)adb_pull– Datei vom Gerät in das lokale Dateisystem übertragenadb_ls– Inhalte des Geräteverzeichnisses auflisten (einfach oder detailliert)adb_cat– Textdatei vom Gerät lesen, optional mit Zeilenlimitadb_file_write– Textdateien per Heredoc erstellen oder überschreiben (Pufferlimit-Warnung, dateisystembewusst, Nachprüfung)adb_find– Dateien nach Name/Muster suchen mit Tiefenkontrolle und Ergebnisbegrenzungadb_file_stat– Dateimetadaten: Größe, Berechtigungen, Zeitstempel, Eigentümer, SELinux-Kontextadb_file_checksum– SHA-256/SHA-1/MD5-Hash mit größenbasierter Timeout-Schätzungadb_mkdir– Verzeichnisse mit Eltern-Erstellung (-p) erstellen, hart blockierte Kernel-Pfadeadb_rm– Dateien/Verzeichnisse löschen mit tiefenbasierter rekursiver Schutz und Symlink-Auflösungadb_file_move– Verschieben/Umbenennen mit Quell-Tiefenschutz und Nachprüfungadb_file_copy– Kopieren mit Vorab-Größen-+Platz-Prüfung und Nachprüfung der Größenübereinstimmungadb_file_chmod– Berechtigungen ändern (Zod-validierter Oktalmodus, tiefenbasierter rekursiver Schutz)adb_file_touch– Leere Dateien erstellen oder Zeitstempel aktualisieren (explizite Zeitstempelunterstützung)adb_file_fsinfo– Dateisystembericht: Typ, Mount, Kapazität, Fähigkeiten, SELinux, Einschränkungenadb_file_chown– Eigentümer ändern (Root erforderlich, tiefenbasierter rekursiver Schutz)adb_grep– Dateiinhalte durchsuchen mit Fixed-String-Standard, rekursiver Tiefenkontrolle, Ergebnisbegrenzungadb_file_replace– Text in Dateien suchen/ersetzen (sed-basiert, korrektes Escaping, Sicherungsoption)
Logs — Snapshots (3 tools)
adb_logcat– Gefilterter Logcat-Snapshot mit Tag, Priorität, grep und Pufferauswahladb_logcat_clear– Alle Logcat-Puffer löschenadb_logcat_crash– Crash-Puffer-Protokoll-Snapshot
Logs — Persistent Watchers (4 tools)
adb_logcat_start– Einen Hintergrund-Logcat-Watcher mit Ringpuffer-Akkumulation startenadb_logcat_poll– Neue Zeilen seit der letzten Abfrage von einem laufenden Watcher abrufenadb_logcat_stop– Eine Watcher-Sitzung (oder alle Sitzungen) beendenadb_logcat_sessions– Alle aktiven Watcher-Sitzungen mit Statistiken auflisten
Diagnostics (9 tools)
adb_dumpsys– dumpsys für einen beliebigen Dienst ausführen (oder alle Dienste auflisten)adb_telephony– Zellinformationen, Signalstärke und Netzwerkregistrierung (parallele Abfrage)adb_battery– Akkustatus, Ladestand, Temperatur und Ladeinformationenadb_network– WLAN, Mobilfunk und IP-Konnektivität (parallele Abfrage)adb_top– CPU- und Speichernutzungs-Snapshotadb_perf_snapshot– Parallele Speicher-, Frame-Statistiken und CPU-Profilerstellung für ein Paketadb_bugreport– Vollständigen Bugreport-ZIP erfassen (Gerätestatus, Protokolle, Systeminformationen)adb_crash_logs– ANR-Traces und Tombstone-Crash-Dumps aus /data/anr/ und /data/tombstones/adb_heap_dump– Heap-Dump (.hprof) von einem laufenden Prozess für die Speicheranalyse erfassen
UI (10 tools)
adb_screencap— Erstellt einen Screenshot mit Dateinamen-Bereinigung und speichert ihn lokaladb_screencap_annotated— Screenshot mit Boundingboxen der UI-Elemente und nummerierten Beschriftungen, die auf das PNG komponiert werden. Gibt den Pfad des annotierten Bildes sowie eine Textlegende zurück. Ideal für LLM-Workflows, die Elemente per Nummer referenzierenadb_current_activity— Ruft die fokussierte Activity und den obersten Fensterstapel abadb_input— Sendet Tipp-, Wisch-, Text- oder Keyevent-Eingabenadb_start_activity— Startet Activities per Intent oder Komponentennamenadb_ui_dump— Gibt die vollständige UI-Hierarchie aus. Unterstützt drei Ausgabeformate:text(Standard, menschenlesbar),tsv(kompakt, tabulatorgetrennt, für token-effiziente Automationsschleifen),xml(rohes uiautomator-XML)adb_ui_find— Durchsucht die UI-Hierarchie nach Text, resource-id oder content-description (liefert Tippkoordinaten)adb_screen_state— Kombinierter Bildschirmzustand in einem Aufruf: Vordergrund-Activity, Bildschirmabmessungen und -dichte, Ausrichtung, Akkustand und eine TSV-Liste interaktiver Elemente. Ersetzt 3–4 separate Tool-Aufrufeadb_screenrecord_start— Startet die Aufnahme des Gerätebildschirms (1–180 s, wird auf dem Gerät gespeichert)adb_screenrecord_stop— Stoppt die Aufnahme und überträgt die mp4-Videodatei lokal
Gerätesteuerung (9 Tools)
adb_airplane_mode— Schaltet den Flugmodus per Broadcast um und verifiziert ihnadb_airplane_cycle— Schaltet den Flugmodus aus/ein, um die erneute Mobilfunkregistrierung zu erzwingenadb_wifi— Aktiviert oder deaktiviert WiFiadb_mobile_data— Aktiviert oder deaktiviert mobile Datenadb_location— Setzt den Standortmodus (off/sensors/battery/high)adb_screen— Weckt den Bildschirm auf, versetzt ihn in den Ruhezustand, schaltet ihn um, sperrt oder entsperrt ihn. Beim Sperren wird der Zustand der Bildschirmsperre überdumpsys windowgeprüft. Beim Entsperren wirdwm dismiss-keyguardverwendet (funktioniert bei Wisch-Sperrbildschirmen); bei Angabe vonpinwird die vollständige PIN-Eingabesequenz ausgeführt: Bildschirm aufwecken, Wischen nach oben zum Einblenden der Tastatur, PIN eingeben, bestätigen und verifizieren, dass das Sleep-Token der Bildschirmsperre freigegeben wurdeadb_settings_get— Liest jede beliebige Android-Einstellung aus dem system/secure/global-Namespaceadb_settings_put— Schreibt jede beliebige Android-Einstellung mit Rücklese-Verifikationadb_reboot— Startet das Gerät neu (Normal-, Recovery- oder Bootloader-Modus)
Drahtloses Debugging (4 Tools)
adb_pair— Koppelt das Gerät über WiFi mit dem Kopplungscodeadb_connect— Verbindet mit dem Gerät über WiFi/TCPadb_disconnect— Trennt drahtlose Geräte von der Verbindungadb_tcpip— Wechselt das USB-Gerät in den TCP/IP-Modus (erkennt die Geräte-IP automatisch)
Port-Weiterleitung (8 Tools)
adb_forward— Leitet einen lokalen Port an einen Geräteport weiter (Host → Gerät)adb_reverse— Leitet einen Geräteport in umgekehrter Richtung an den Host weiter (Gerät → Host)adb_forward_list— Listet alle aktiven Vorwärts- und Rückwärts-Portzuordnungen aufadb_forward_remove— Entfernt eine Portweiterleitung oder alle Weiterleitungenadb_reverse_remove— Entfernt eine umgekehrte Weiterleitung oder alle umgekehrten Weiterleitungenadb_tunnel_open— Öffnet einen verwalteten Tunnel mit opaker ID. Wenn keine Angabe erfolgt, wird automatisch ein freier Host-Port für die Vorwärtsrichtung gewählt; registriert eine Aufräumfunktion, damit der Tunnel beim Beenden des Servers entfernt wirdadb_tunnel_list— Listet aktive verwaltete Tunnel auf (solche, die über adb_tunnel_open geöffnet wurden). Optionaler Gerätefilter; zeigt ID, Richtung, Endpunkte und Alter anadb_tunnel_close— Schließt einen verwalteten Tunnel anhand der ID oder schließt mit id="all" alle auf einmal
Emulatorverwaltung (3 Tools)
adb_avd_list— Listet verfügbare AVDs auf (PC-Modus) oder erkennt KVM-/QEMU-Virtualisierungsfunktionen (Gerätemodus)adb_emulator_start— Startet ein AVD mit headless, Kaltstart- und GPU-Optionen (PC-Modus) oder meldet die QEMU-Alternative (Gerätemodus)adb_emulator_stop— Fährt einen laufenden Emulator sauber herunter
QEMU/KVM-Virtualisierung (8 Tools)
adb_qemu_setup— Prüft und installiert QEMU für die On-Device-Virtualisierung. Verifiziert KVM, meldet Host-CPU/RAM und installiert über Termux pkgadb_qemu_images— Verwaltet VM-Datenträger-Images: Auflisten, Erstellen (qcow2/raw), Löschen. Verhindert durch Verzeichnisbegrenzung Pfad-Traversaladb_qemu_start— Bootet eine KVM-beschleunigte VM mit dynamischer Ressourcenzuweisung. Erkennt automatisch die optimale CPU-Anzahl (Gesamtzahl minus 1, eine für den Host) und den Speicher (65 % des physischen RAMs). Unterstützt kernel/initrd/append für den Android-Boot sowie ADB-Portweiterleitungadb_qemu_stop— Stoppt eine laufende VM (sauberes SIGTERM oder erzwungenes SIGKILL). Trennt automatisch die Gast-ADB-Verbindung, bevor sie beendet wird. Meldet bei fehlendem Namen laufende VMsadb_qemu_status— Vollständiger Status: KVM/QEMU-Verfügbarkeit, Host-Ressourcenbudget, laufende VMs mit PID/Ressourcen/Uptime/Ports/ADB-Verbindungszustand sowie Image-Inventaradb_qemu_connect— Verbindet mit dem Gast-ADB-Dienst einer laufenden VM. Auf localhost beschränkt – der Port wird aus dem Zustand der laufenden VM abgeleitet, nie aus Benutzereingaben. Ermöglicht Multi-Geräte-Tools auf Gast-VMsadb_qemu_disconnect— Trennt die Verbindung zum ADB-Dienst einer Gast-VM. Löscht den Verbindungsstatus und entfernt den Gast aus der Gerätelisteadb_qemu_guest_shell— Führt per ADB Shell-Befehle auf einer Gast-VM aus. Unterliegt der Sicherheits-Middleware. Die Gast-Seriennummer wird intern abgeleitet – keine benutzereigene Host/IP erreicht das ADB-Binary
Testsitzungen (3 Tools)
adb_test_session_start— Startet eine benannte Testsitzung mit strukturiertem Ausgabeverzeichnisadb_input
adb_test_step— Erfasst in der Sitzung einen nummerierten Schritt mit Screenshot und Logcat
adb_test_session_end— Beendet die Sitzung, schreibt das Summary-Manifest und gibt den Verzeichnispfad zurück
Multi-Geräte-Orchestrierung (4 Tools)
adb_multi_shell— Führt einen Befehl auf allen/ausgewählten Geräten parallel aus (sicherheitsgeprüft)adb_multi_install— Installiert eine APK gleichzeitig über mehrere Geräteadb_multi_compare— Führt einen Befehl auf allen Geräten aus und hebt Ausgabeunterschiede hervoradb_multi_test— Vergleichender Test-Workflow: führt vorkonfigurierte Diagnoseprofile (firmware/security/network/identity/full) oder benutzerdefinierte Befehlslisten auf allen Geräten einschließlich QEMU-Gästen aus, gleicht pro Prüfung ab und meldet Übereinstimmungen sowie Unterschiede
Eingabegesten & UI-Automatisierung (15 Tools)
adb_input_drag— Drag from Punkt A to Punkt B (verwendetdraganddropmit Wisch-Fallback bei älterem Android)adb_input_fling— Hochgeschwindigkeits-Fling-Geste für Momentum-Scrolling durch Listen und umgeblätterte Ansichten (konfigurierbare Dauer 20–200 ms)adb_input_long_press— Langes Drücken an Koordinaten mit konfigurierbarer Haltezeitadb_input_double_tap— Doppeltippen mit konfigurierbarem Intervall zwischen den Tippsadb_input_text— Spezielle Texteingabe mit Verarbeitung von Leer- und Sonderzeichenadb_open_url— Öffnet über einen VIEW-Intent eine URL auf dem Gerätadb_orientation— Ermittelt oder setzt die Bildschirmorientierung (auto/portrait/landscape/reverse)adb_clipboard— Liest oder schreibt die Geräte-Zwischenablageadb_input_pinch— Multi-Touch-Pinch (Zoom out) oder Spread (Zoom in). Zwei Finger bewegen sich symmetrisch um einen Mittelpunkt. Die Injektion erfolgt mehrschichtig: parallelesinput swipe(universell, kein Root) oder rohessendevent-MT-Typ-B-Protokoll (echtes Multi-Touch, Root erforderlich). Touchscreen-Gerät und Fähigkeiten werden übergetevent -pautomatisch erkannt. Konfigurierbar sind Mittelpunkt, Radius, Dauer, Winkel und Interpolationsschritteadb_tap_element— Findet Elemente nach Text/Ressourcen-ID/content-description und tippt deren Mittelpunkt anadb_wait_element— Pollt die UI-Hierarchie, bis ein Element erscheint oder verschwindet (konfigurierbares Timeout/Poll-Intervall)adb_wait_stable— Pollt, bis aufeinanderfolgende UI-Dumps übereinstimmen (Bildschirmstabilisierung nach Übergängen)adb_scroll_until— Scrollt wiederholt, bis das Zielelement gefunden wird, wobei ein Auto-Tipp optional istadb_screenshot_compressed— Erstellt einen Screenshot mit Größen-/Qualitätsmetadaten für token-effiziente Arbeitsabläufeadb_batch_actions— Führt mehrere Eingabeaktionen (tap/swipe/fling/long_press/double_tap/keyevent/text/drag/pinch/back/home/sleep) in einem einzigen Tool-Aufruf mit Sicherheitsprüfung aus
Geräteinformationen (3 Tools)
adb_screen_size— Bildschirmauflösung, Anzeigedichte (DPI), Seitenverhältnis und DP-Breite in einem Aufrufadb_device_state— Kombinierter Schnappschuss: Akkulastand/-status/-temperatur, Netzwerktyp, WiFi-Zustand, Bildschirm an/aus, Ausrichtung, im Vordergrund befindliche Activityadb_notifications— Parst aktive Benachrichtigungen mit Paket, Titel, Text, Wichtigkeit, Kanal, Flags und Timestamp (filterbar nach Paket)
Snapshot/Wiederherstellung (3 Tools)
adb_snapshot_capture— Speichert den umfassenden Gerätezustand (Pakete, Einstellungen, Eigenschaften) als JSONadb_snapshot_compare— Vergleicht den aktuellen Stand mit einem gespeicherten Snapshot (hinzugefügte/entfernte Pakete, geänderte Einstellungen)adb_snapshot_restore_settings— Stellt global/secure-Einstellungen aus einem gespeicherten Snapshot wieder her
Netzwerk-Erfassung (3 Tools)
adb_tcpdump_start— Startet eine Hintergrund-Paketerfassung über tcpdump (erforderlich)adb_tcpdump_stop— Stoppt die Erfassung und zieht die pcap-Datei für Wireshark-Analysen lokaladb_network_connections— Zeigt aktive TCP/UDP-Verbindungen (ss/netstat mit Fallback auf /proc/net)
CI/CD-Integration (3 Tools)
adb_ci_wait_boot— Wartet mit konfigurierbarem Timeout auf den vollständigen Boot des Geräts bzw. Emulatorsadb_ci_device_ready— Strukturierter Pass/Fail-Bereitschaftscheck (Boot, PM, Bildschirm, Netzwerk, Disk)adb_ci_run_tests— Führt instrumentierte Tests überam instrumentaus und parst die Ergebnisse als bestanden/nicht bestanden
Basisband/Modem (6 Tools)
adb_baseband_info— Modem-Firmware, RIL-Implementierung, Chipsatz, SIM-Konfiguration (Dual-SIM-Erkennung mit Zustand pro Slot), Netzregistrierung. IMEI-Abruf erfolgt ausschließlich optional (includeImei=true)adb_cell_identity— Cell ID (CID), TAC/LAC, EARFCN, PCI, PLMN aus dumpsys phone zur Mobilfunknetzanalyseadb_signal_detail— RSRP, RSRQ, SINR, RSSI, Timing-Advance — rohe Funkmesswerte für die Signalanalyseadb_neighboring_cells— Alle sichtbaren LTE/5G/WCDMA/GSM-Zellen mit Identitäten und Signalstärkenadb_carrier_config— Carrier-Konfigurationsdump, Carrier-ID, bevorzugter APNadb_modem_logs— RIL-Funkpuffer, Telefonie-Framework, RILJ/RILC, Kernel dmesg (Root)-Protokolle
Barrierefreiheits-Audit (3 Tools)
adb_a11y_audit— Automatisierte WCAG-Prüfung: fehlende Labels, zu kleine Touch-Ziele (<48 Elem), doppelte Beschreibungen, nicht fokussierbare Klick-Elementeadb_a11y_touch_targets— Listet alle interaktiven Elemente mit Touch-Zielmaßen in dp auf und kennzeichnet zu kleineadb_a11y_tree— Barrierefreiheits-fokussierter UI-Baum mit nur Screenreader-relevanten Elementen und Rollen, Labels und State-Informationen
Regressionserkennung (3 Tools)
adb_regression_baseline— Erfasst die Leistungsbasislinie (Speicher, CPU, Frame-Statistiken, Akku, Netzwerk) als JSONadb_regression_check— Vergleicht die aktuelle Leistung mit einer gespeicherten Basislinie sowie konfigurierbaren Auslöseschwellenadb_regression_history— Listet alle gespeicherten Basislinien mit Trend auf, optional gefiltert nach Paket
Device Farm (3 Tools)
adb_farm_run— Führt instrumentierte Tests auf Firebase Test Lab über mehrere Gerätemodelle und API-Ebenen ausadb_farm_results— Ruft Ergebnisse eines Test-Lab-Laufs ab oder listet aktuelle Test-Matrizen aufadb_farm_matrix_nis— Listet auf Firebase Test Lab verfügbare Gerätemodelle und Android-Versionen auf
Plugin-Registry (3 Tools)
adb_registry_search— Durchsucht die Community-Plugin-Registry und zeigt Installationsstatus und verfügbare Updatesadb_registry_install— Lädt ein Plugin aus der Registry herunter und installiert es namentlichadb_registry_installed— Listet lokal installierte Plugins mit Version und Update-Verfügbarkeit
Plugins (2 Tools)
adb_plugin_listadb_at_detect— Automatische Erkennung des AT-Befehls-Geräteknotens des Modems anhand der Chipsatz-Familie (Shannon, Qualcomm, MediaTek, Unisoc, generisch). Durchsucht bekannte Pfade und gibt den ersten antwortenden Knoten zurückadb_at_send— Sendet einen einzelnen AT-Befehl an das Modem mit Antwort-Erfassung. Automatische Port-Erkennung oder manuelle Überschreibung möglich. Blocklist für gefährliche Befehle mit Force-Überschreibungadb_at_batch— Sendet mehrere AT-Befehle nacheinander mit Ergebnissen pro Befehl. Konfigurierbare Verzögerung zwischen Befehlenadb_at_probe— Führt eine standardmäßige Diagnoseprüfung durch: Modem-ID, Signalqualität, Netzregistrierung, SIM-Status, Betreiber, Funktionsmodusadb_at_cross_validate— Kreuzvalidiert die Basisband-Firmware durch Vergleich der AT-Befehlsantworten (ATI, AT+CGMR, AT+CGMM) mit Systemeigenschaften. Kennzeichnet Abweichungen als mögliche Firmware-Manipulation, unvollständiges OTA oder Property-Spoofing. Shannon-spezifische AT+DEVCONINFO-Unterstützung. Erfordert Root
Screenshot-Diffing (3 Tools)
adb_screenshot_baseline— Erfasst und speichert eine benannte Screenshot-Baseline mit Metadaten (Abmessungen, SHA-256, Zeitstempel)adb_screenshot_diff— Vergleicht den aktuellen Bildschirm mit einer gespeicherten Baseline mittels Pixel-genauer PNG-Dekodierung. Meldet Anzahl/Prozentsatz geänderter Pixel, Begrenzungsrahmen des geänderten Bereichs und unterstützt einen Toleranzschwellenwert zur Absorption dynamischer Elemente wie Uhrenadb_screenshot_history— Listet alle gespeicherten Screenshot-Baselines mit Metadaten auf
Workflow-Orchestrierung (3 Tools)
adb_workflow_run— Führt einen JSON-definierten Workflow aus: sequenzielle Geräteoperationen mit Variablenersetzung, bedingten Schritten, Schleifen und Ergebnis-Erfassung. Aktionen: shell, root_shell, install, screenshot, logcat, getprop, sleepadb_workflow_validate— Validiert die Workflow-Struktur ohne Ausführung. Zeigt den Ausführungsplanadb_workflow_list— Listet gespeicherte Workflow-Dateien im Workflows-Verzeichnis auf
Split-APK-Verwaltung (4 Tools)
adb_install_bundle— Installiert Split-APKs (App-Bundles) überinstall-multiplemit Ersetzungs- und Downgrade-Optionenadb_list_splits— Zeigt alle APK-Split-Pfade für ein Paket mit Klassifizierung (base, config.density, config.language, usw.) und Gesamtgrößeadb_extract_apks— Zieht alle Splits für ein Paket in ein lokales Verzeichnis zur Analyse oder Sicherungadb_apex_list— Listet installierte APEX-Module mit Versionsinformationen auf
Gerätespiegelung (3 Tools)
adb_mirror_start— Startet Live-Bildschirmspiegelung über scrcpy. Unterstützt Fenster- und Headless-Modi, Aufzeichnung, Bitrate/FPS/Auflösungssteuerung, Wachhalten und Bildschirm-ausadb_mirror_stop— Stoppt die Spiegelung für ein Gerät oder alle Geräteadb_mirror_status— Prüft die scrcpy-Verfügbarkeit und listet aktive Spiegelungssitzungen auf
Automatisierte Testgenerierung (3 Tools)
adb_test_gen_from_ui— Analysiert die interaktiven Elemente des aktuellen Bildschirms und generiert einen Workflow, der jedes Element antippt, Screenshots erstellt und auf Abstürze prüftadb_test_gen_from_intents— Analysiert die registrierten Aktivitäten eines Pakets und generiert einen Workflow, der jede exportierte Aktivität mit Absturzerkennung startetadb_test_gen_save— Speichert einen generierten Workflow-JSON im Workflows-Verzeichnis zur späteren Ausführung
OTA-Update-Überwachung (3 Tools)
adb_ota_fingerprint— Erfasst den System-Fingerabdruck: Build-ID, Android-Version, Sicherheitspatch, Bootloader, Basisband-Firmware, Kernel, A/B-Slotadb_ota_check— Vergleicht den aktuellen Systemzustand mit einem gespeicherten Fingerabdruck, um OTA-Updates zu erkennen. Identifiziert geänderte Felder und empfiehlt eine neue Baseline-Erstellungadb_ota_history— Listet alle gespeicherten Fingerabdrücke für ein Gerät mit Versionsverlauf über die Zeit auf
RIL-Nachrichten-Erfassung (3 Tools)
adb_ril_start— Startet die Erfassung von RIL-Nachrichten aus dem Radio-Logcat-Puffer. Kategorisiert Registrierungs-, Zellinfo-, Signal-, Netzwerk-, Sicherheits-, Handover- und NAS-Ereignisseadb_ril_poll— Ruft erfasste RIL-Nachrichten mit optionaler Kategoriefilterung ab. Zeigt die Kategorieverteilungadb_ril_stop— Stoppt eine RIL-Erfassungssitzung mit Kategoriezusammenfassung
Geräteprofile (3 Tools)
adb_profile_detect— Automatische Erkennung und Erstellung eines Geräteprofils: Hardware-ID, Chipsatz-Familie, Modem-Knoten, Root-Status, 5G-Unterstützung, Dual-SIM-Konfiguration. Abgleich mit der integrierten Bibliothek auf bekannte Besonderheitenadb_profile_save— Speichert ein Geräteprofil in der Profilbibliothekadb_profile_list— Listet integrierte und benutzergespeicherte Geräteprofile auf
Modem-Firmware-Analyse (3 Tools)
adb_firmware_probe— Umfassende Firmware-Identifizierung: parst Basisband (Shannon/Qualcomm/MediaTek/Unisoc/HiSilicon/Intel), Bootloader und RIL-Implementierung in strukturierte Komponenten. Meldet Kernel, Sicherheitspatch, A/B-Slot, Verified-Boot-Status, VBMeta, Hypervisor und OTA-Partitionsinventaradb_firmware_diff— Vergleicht alle Firmware-Komponenten (Basisband, Bootloader, Kernel, Sicherheitspatch, Build-ID, Android-Version, RIL) zwischen gespeicherten Fingerabdrücken oder dem Live-Gerät. Tiefgehende geparste Diffs für Basisband und Bootloader bei erkannten Änderungenadb_firmware_history— Verfolgt den Firmware-Verlauf über alle gespeicherten OTA-Fingerabdrücke mit Mehrkomponenten-Änderungserkennung (Basisband, Bootloader, Kernel, Sicherheitspatch, Build-ID, Android-Version) und geparsten Basisband-Diffs
Drahtlose Firmware (4 Tools)
adb_wifi_firmware— WiFi-Chipsatz- und Firmware-Identifizierung: Treiberversion, Firmware-Version, unterstützte Bänder (2,4/5/6 GHz), WiFi-Standard-Erkennung (5/6/6E/7), aktuelle Verbindungsinformationen. MAC-Adresse nur mit Opt-inadb_bluetooth_firmware— Bluetooth-Firmware- und Chipsatz-Identifizierung: Firmware-Version, BT-Version (4.0–5.4 aus LMP), Adapterstatus, LE-Fähigkeiten (2M PHY, Coded PHY, erweitertes Advertising), aktive Profile (A2DP/HFP/HID/LE Audio), Anzahl gekoppelter Geräte. MAC/Name nur mit Opt-inadb_nfc_firmware— NFC-Controller-Firmware: Controller-Typ (NXP/Broadcom/Samsung/ST), Firmware-Version, unterstützte Technologien (NFC-A/B/F/V, MIFARE), Secure Element (eSE/UICC), HCE-Unterstützungadb_gps_firmware— GNSS/GPS-Chipsatz- und Firmware-Identifizierung: Hardware-Modell (Hersteller, Chip, Firmware), unterstützte Konstellationen (GPS/GLONASS/Galileo/BeiDou/QZSS/NavIC/SBAS), Signaltypen mit Frequenzen, Dual-Frequenz-Erkennung (L1+L5), Roh-GNSS-Messfähigkeiten, A-GPS-Modi (MSB/MSA), SUPL-Serverkonfiguration, Trägerphasenmessungen
Workflow-Marktplatz (3 Tools)
adb_market_search— Durchsucht den Workflow-Marktplatz nach von der Community geteilten Workflow-Definitionen mit Schlüsselwort- und Tag-Filterung. Zeigt den Installationsstatusadb_market_install— Lädt einen Marktplatz-Workflow herunter, validiert (JSON-Struktur + SHA-256-Integrität) und installiert ihn zur sofortigen Verwendung mit adb_workflow_runadb_market_export— Verpackt einen lokalen Workflow mit Marktplatz-Metadaten (Autor, Version, Tags, SHA-256) und generiert einen Registry-Manifesteintrag zum Teilen
SELinux- und Berechtigungsprüfung (3 Tools)
adb_selinux_status— SELinux-Erzwingungsmodus, Policy-Version, Shell-Kontext, Anzahl aktueller AVC-Verweigerungen. Root liefert Kernel-dmesg-Verweigerungsstatistikenadb_selinux_denials— Listet aktuelle AVC-Verweigerungsmeldungen mit geparsten Quell-/Zielkontexten, Berechtigungsklassen und verweigerten Operationen auf. Unterstützt Prozessfilterungadb_permission_audit— Prüft Laufzeitberechtigungsvergaben für ein Paket, gruppiert nach gefährlicher Berechtigungskategorie (Kamera, Standort, Telefon, SMS, usw.). Kennzeichnet hochsensible Vergaben
Thermik- und Energieprofilierung (3 Tools)
adb_thermal_snapshot— Erfasst alle Thermikzonen-Temperaturen, Pro-CPU-Frequenzen/Governor, Kühlgerätezustände, Batterietemperatur/-strom/-spannung/-leistungsaufnahme. Optionales Speichern als JSON-Baselineadb_thermal_compare— Vergleicht den aktuellen Thermikzustand mit einer gespeicherten Baseline mit Temperaturdeltas pro Zone und Batteriestromänderungenadb_battery_drain— Misst die Batterieentladungsrate über eine konfigurierbare Dauer (3–60 s). Meldet durchschnittlichen mA, mW, geschätzte %/Stunde. Optionale paketspezifische Batterystats
Netzwerkerkennung (3 Tools)
adb_network_scan— Scannt das lokale Netzwerk nach ADB-fähigen Geräten über die ARP-Tabelle und optionalen IP-Bereichs-Sweep. Prüft Ports 5555–5558 mit gebündelten parallelen TCP-Probesadb_network_device_ip— Ermittelt die WiFi-IP eines verbundenen Geräts über mehrere Methoden. Zeigt den ADB-TCP-Status und Anweisungen zur drahtlosen Verbindungadb_network_auto_connect— Ein-Schritt-Erkennung + Verbindung: scannt nach ADB-Geräten und führt automatisch adb connect auf jedem gefundenen Listener aus
Hardware-Sensorzugriff (2 Tools)
adb_sensor_read— Liest aktuelle Hardware-Sensorwerte über dumpsys sensorservice. Zählt alle Sensoren mit Hersteller, Typ, Modus, Ratenbereich und Wake-Fähigkeit auf. Gibt letzte bekannte Messwerte mit Zeitstempeln und achsenbeschrifteter Formatierung zurück. Kategoriefilter (13 Kategorien) und listOnly-Erkennungsmodus. Kein Root erforderlichadb_iio_read— Liest rohe Hardwaredaten aus dem Linux-IIO-Subsystem. Entdeckt IIO-Geräte automatisch und klassifiziert sie nach Kernel-Treiber. Auf Tensor/Exynos: legt ODPM-Leistungsmonitore pro Schiene offen, die den Echtzeit-Leistungsverbrauch pro SoC-Subsystem zeigen. Generischer IIO-Pfad behandelt Rohkanäle mit kalibrierter Skalierung + Offset. Root erforderlich
Ergebnis-Handles (3 Tools)
adb_result_list— Listet aktive Ergebnis-Handles im tempdir-gestützten Cache auf. Zeigt Tool, Name, Größe, Alter und verbleibende TTL für jeden Handleadb_result_get— Ruft den Inhalt eines gespeicherten Handles nach Tool + Name ab. Gibt die ursprünglichen Inhaltsblöcke zurück, wie sie das Quell-Tool erzeugt hat; aktualisiert die letzte Zugriffszeit. Für URI-basierte Abfrage verwenden Sie stattdessen die MCP-Ressourceresult://{tool}/{name}adb_result_drop— Löscht einen gespeicherten Ergebnis-Handle oder löscht alle Handles im aktuellen Namensraum. Übergeben Sie sowohltoolals auchname, um einen bestimmten Handle zu löschen, oderall: true, um alles zu löschen. Nützlich vor dem Ändern von DA_AUTH_TOKEN (das sonst verwaiste Einträge unter dem alten Token-Hash-Verzeichnis hinterlassen würde)
MCP-Ressourcen (5)
Schreibgeschützte Gerätezustandsflächen, die für MCP-Clients zugänglich sind:
device://list— Liste aller verbundenen Geräte mit Status- und Modellinformationendevice://info/{serial}— Geräteeigenschaften (Modell, OS, Build, ABI)device://battery/{serial}— Geparster Batteriestatus (Ladestand, Laden, Temperatur, Spannung)device://telephony/{serial}— Telefonie-Registry-Zustand für Zellanalyseresult://{tool}/{name}— Gespeicherter Tool-Ergebnis-Handle. Über URI auflösbar; erstellt von Tools, die sich über den Parameterresult_handlefür die Ergebnis-Handle-Speicherung entscheiden. Aufgelistet von adb_result_list
MCP-Prompts (4)
Vorgefertigte Workflow-Vorlagen für häufige mehrstufige Debugging-Aufgaben:
debug-crash— Logcat leeren → App neu starten → auf Reproduktion warten → Absturzpuffer erfassen → analysierendeploy-and-test— Build → installieren → Logcat leeren → Watcher starten → starten → Screenshot → Berichttelephony-snapshot— Telefoniezustand, SIM-/Netzbetreiber, Netztyp erfassen → Anomalien zusammenfassenairplane-cycle-test— Watcher starten → Telefonie-Baseline → Flugmodus durchlaufen → Vorher/Nachher-Zustand vergleichen
Hauptfunktionen
Geräte-Caching
Ergebnisse der Geräteerkennung werden mit einer konfigurierbaren TTL (Standard 5 s) zwischengespeichert, wodurch redundante adb devices-Subprozessaufrufe bei schnellen Tool-Sequenzen entfallen. Der Cache invalidiert automatisch bei Verbindungsfehlern und nach drahtlosen Verbindungs-/Trennungs-/Pairing-Operationen.
Wiederholung bei vorübergehenden Fehlern
Die ADB-Brücke wiederholt automatisch bei vorübergehenden Fehlern (Gerät offline, Verbindungsreset, Protokollfehler) mit konfigurierbarer Wiederholungsanzahl und exponentiellem Backoff. Diagnosebefehle überspringen Wiederholungen, um echte Probleme sofort sichtbar zu machen.
Ausgabeschutz
Die gesamte ADB-Ausgabe durchläuft den OutputProcessor, der Zeilenenden normalisiert, konfigurierbare Zeichenlimits durchsetzt und eine kontextbezogene Kürzung an logischen Grenzen (Zeilenumbrüche, Abschnittstrenner) statt mitten in der Zeile vornimmt. Enthält strukturierte Parser für Batterie-, Meminfo- und getprop-Ausgabe.
Persistentes Logcat-Streaming
Logcat-Hintergrundwächter laufen als separate Hintergrundprozesse mit Ringpuffer-Akkumulation. Jede Abfrage liefert nur neue Zeilen seit dem letzten Lesevorgang zurück. Unterstützt mehrere gleichzeitige Sitzungen (bis zu 10) mit unabhängigen Filtern. Prozess-Cleanup-Handler verhindern verwaiste adb logcat-Prozesse beim Server-Exit.
UI-Hierarchie-Analyse
Erfassung des vollständigen View-Baums über uiautomator dump mit geparster XML-Extraktion. Liefert strukturierte Elementdaten, darunter Text, resource-id, content-description, Klassennamen, Bounds-Koordinaten mit tippbaren Mittelpunkten und Interaktionsflags. Vorkompilierte Regex-Attributextraktion für effizientes Parsing.
Sicherheits-Middleware
Mehrschichtige Sicherheit, aktiviert über DA_SECURITY=true. Bietet Blocklist-/Allowlist-Filterung für Befehle, Ratenbegrenzung (Befehle pro Minute) und Audit-Logging mit automatischer Schwärzung von Zugangsdaten. Die Sicherheitsprüfungen sind in adb_shell, adb_root_shell, adb_multi_shell, adb_multi_compare, adb_input, adb_batch_actions und adb_start_activity integriert. Über Umgebungsvariablen für verschiedene Einsatzszenarien konfigurierbar.
Eingabebereinigung
Alle Tools, die benutzergelieferte Parameter in Shell-Befehlszeichenketten interpolieren, validieren die Eingaben vor der Ausführung gegen Shell-Metazeichen. Paketnamen, Property-Keys, Dienstnamen, Setting-Keys, Testbezeichner, Netzwerkschnittstellennamen und tcpdump-Filter werden über eine zentrale validateShellArg()-Funktion validiert, die ;, |, &, $, Backticks, Klammern und andere Injektionsvektoren ablehnt. Dateipfade verwenden Single-Quoted-Shell-Escaping, um die $()-Befehls substitution zu verhindern. Das adb_input-Tool wendet typspezifische Validierung an: tap/swipe akzeptieren nur numerische Koordinaten, keyevent nur alphanumerische Keycodes und text wird für die wörtliche Zustellung durch Shell-Escaping maskiert. Das adb_batch_actions-Tool erzwingt dieselbe Validierung pro Aktionsstyp (nur Ziffern für Koordinaten, alphanumerisch für Keycodes, Shell-Escaping für Text) und leitet jeden zusammengesetzten Befehl durch die Sicherheits-Middleware. Deserialisiertes JSON aus Snapshot-Dateien wird vor der Shell-Interpolation validiert. Jeder z.number()-Parameter in allen 204 Tools besitzt explizite .min()/.max()-Zod-Grenzen, um eine Ressourcenerschöpfung durch extreme Werte zu verhindern. Der LocalBridge hat explizite Handler für jeden ADB-Unterbefehl, den die Tool-Module verwenden, und verhindert so das unquotierte Durchreichen an den Standard-Shell-Handler. Im On-Device-Modus nutzt die Privilegieneskalation eine eingefrorene 16-Befehle-Allowlist und eine Regex für eingeschränkte Pfade – der Elevationssatz besteht aus ReadonlySet + Object.freeze und ist zur Laufzeit nicht konfigurierbar. Der HTTP/SSE-Transport lehnt Cross-Origin-Anfragen standardmäßig ab (konfigurierbar über DA_HTTP_CORS_ORIGIN), die Plugin-Registry verifiziert SHA-256-Integritätswirbel und verhindert Path Traversal durch Verzeichnis-Containment-Prüfungen, und die Workflow-Engine setzt Begrenzungen für Schrittzahl (200), Schlafdauer (5 Min.) und Wiederholungen (100) durch. Fetch-Helfer erzwingen ein Limit von 5 MB für den Antwort-Body. Das Getprop-Ausgabeparsing verarbeitet Windows-\r\n-Zeilenden über .trim() vor dem Regex-Abgleich, und die Anzahl der Dual-SIM-Slots ist auf 4 begrenzt, um Ressourcenerschöpfung durch beschädigte Geräteeigenschaften zu verhindern.
Multi-Geräte-Orchestrierung
Befehle ausführen, APKs installieren und Ausgaben über mehrere verbundene Geräte hinweg parallel vergleichen. Unverzichtbar für vergleichende Tests über mehrere Android-Versionen und Gerätemodelle hinweg.
Snapshot/Wiederherstellung
Erfasst umfassende Gerätezustands-Snapshots (Pakete, Einstellungen über alle Namespaces, Systemeigenschaften) als JSON-Dateien. Vergleicht den aktuellen Zustand mit gespeicherten Snapshots, um Abweichungen zu erkennen. Stellt Einstellungen aus Snapshots wieder her, um reproduzierbare Testumgebungen zu schaffen.
Netzwerkverkehr-Erfassung
Paketerfassung auf dem Gerät über tcpdump mit pcap-Datei-Abruf für die Wireshark-Analyse. Enthält die Auflistung aktiver Verbindungen über ss/netstat mit /proc/net-Fallback für Geräte ohne diese Tools.
CI/CD-Integration
Speziell für automatisierte Pipelines entwickelte Tools: Warten auf den Geräte-Boot mit Polling, strukturierte Bereitschaftsprüfungen und instrumentierte Testausführung mit geparsten Pass/Fail-Ergebnissen.
Plugin-Architektur
Dynamisches Laden von Tool-Modulen aus einem konfigurierbaren Plugins-Verzeichnis. Plugins sind reguläre JavaScript-ESM-Module, die eine register(ctx)-Funktion exportieren und den vollständigen ToolContext erhalten. Werden beim Serverstart geladen und ermöglichen Community-Brträge ohne Änderungen am Kerncode.
Community-Plugin-Registry
Plugins aus einer konfigurierbaren Registry-URL suchen, installieren und verwalten. Zeigt Installationsstatus, Versionsvergleich und verfügbare Updates an. Lädt Plugin-Dateien mit Begleit-Informationen Metadaten in das Plugins-Verzeichnis, damit sie beim nächsten Neustart geladen werden. Zu den Sicherheitsfunktionen gehören die SHA-256-Integritätsprüfung (sofern im Registry-Manifest angegeben), Path-Traversal-Schutz und eine Plausibilitätsprüfung des register()-Exports.
Basisband-/Modem-Integration
Tools zur tiefgehenden zellularen Funkdigitaleinsübung für fortgeschrittene Android-Entwicklung und -Forschung. Extrahiert Modem-Firmware-Identifikation, Zellidentitätsparameter (CID, TAC, EARFCN, PCI), rohe Signalmessungen (RSRP, RSRQ, SINR), Nachbarzellen-Erkundungen, Konfiguration des Betreibers und Modem-Protokolle aus mehreren Quellen (RIL-Radiopuffer, Telekommunikations-Framework, Kernel-Dmesg). Unterstützt Shannon/Exynos-, Qualcomm-, MediaTek- und Unisoc-Chipsatzfamilien über die standardmäßigen Android-Telefonie-APIs. Enthält Google-Tensor-SoC-Erkennung (gs101/gs201/zuma/zumapro) für das automatische Shannon-Modem-Pfadrouting auf Pixel-6–9-Geräten. Die Dual-SIM-Erkennung meldet pro Slot SIM-Zustand, Betreiber, Netzwerktyp und Land für DSDS-, DSDA- und TSTS-Konfigurationen.
Barrierefreiheits-Auditierung
Automatisierte WCAG-Barrierefreiheitsprüfungen an der LiveerUI-Hierarchie. Erkennt fehlende Labels auf interaktiven Elementen, zu kleine Touch-Ziele unterhalb der 48-dp-Richtlinie (densitätsbewusst), Bilder ohne content-description, klickbare Elemente ohne Rücksetzbarkeit und doppelte content-descriptions. Generiert strukturierte Berichte mit Schweregraden. Enthält eine dedikierte Barrierefreiheits-Baumanansicht für Screenreader- Debugging.
Regressionserkennung
Erfasst Performance-Baselines (Speicher, CPU, Frame-Statistik, Akku, Netzwerkzustand) und vergleicht unterschiedliche nachfolgendeäufe damit. Konfigurierbare Regressionsschwellen für Speicher (+20 %), CPU (+50 %) und Jank-Rate (+25 %). Hält eine Historie der Baselines für die Trendanalyse über Versionen hinweg bereit.
Device-Farm-Integration
Cloud-basierte Testausführung über Firebase Test Lab per gcloud-CLI. Führen Sie instrumente Tests auf mehreren Gerätemodellen und API-Leveln aus, rufen Sie strukturierte Ergebnisse ab und listen Sie die verfügbereitungen Test-Matrix-Konfigurationen auf. Saubere Fallback-Lösung mit Einrichtungsanweisungen, falls gcloud nicht verfügbar ist.
HTTP/SSE-Transport
Alternative zu stdio für browserbasierte MCP-Clients. Setzen Sie DA_HTTP_PORT, um einem HTTP-Server mit SSE-Streaming zu starten. Stellt /sse (Client-Abonnement), /message (JSON-RPC) und /health-Endpunkte bereit. Cross-Origin-Anfragen werden standardmäßig abgewiesen – setzen Sie DA_HTTP_CORS_ORIGIN, um einen bestimmten Absender explizit zuzulassen.
Test-Sitzungsverwaltung
Strukturierte Tests Workflows mit nummerierten Schritten. Jeder Schritt erfasst einen Screenshot und einen Logcat-Snapshot in einem organisierten Verzeichnis mit einem Markdown-Manifest. Konzipiert für die reproduzierbare Dokumentation der Tests.
AT-Befehlsschnittstelle
Direkter AT-Befehlspassthrough zum Modem über Root-Zugriff und ermöglicht Abfragen jenseits des Android-Telekommunikations-Frameworks. Multi-Chipset-Unterstützung erkennt automatisch Geräteknoten für Samsung Shannon/Exynos, Qualcomm Snapdragon, MediaTek, Unisoc/Spreadtrum und generische USB-Modems. Die Eingabevalidierung lehnt Shell-Metazeichen aus AT-Befehlszeichenfolgen und Geräteknotenpfaden ab, bevor sie auf eine Root-Shell übertragen werden. Eine Sicherheitsblocklist verhindert unbeabsichtigte Ausführung gefährlicher Befehle (AT+CFUN=0, AT+EGMR usw.) mit einem expliziten Force-Override.
Screenshot-Diffing
Echte Pixel-genaue optische Regressionserkennung. Erfasst benannte Screenshot-Baselines und vergleicht den aktuellen Bildschirmzustand, indem sie PNG-Pixeldaten dekodiert (IHDR-Parsing, IDAT-Dekompression, alle 5 PNG-Filtertypen) und die tatsächlichen RGB-Werte vergleicht. Meldet die Anzahl und der Prozentsatz geänderter Pixel, den umgebenden Rahmen der geänderten Region mit vertikaler Bildschirmposition sowie Dimensions-/Größen-Änderungenänderungen. Unterstützt einen tolerancePercent-Parameter (0–100), der kleine dynamische Änderungen wie Uhranzeigen perfekt oder Benachrichtigungsabzeichen abfängt – eine Toleranz von 1 % st auffällig Uhränderungen der Navigationsleiste (~0,5 % der Pixel) absorbiert und trotzdem jede echte UI-Regression erkennt. SHA-256-Schnellpfad für exakte Übernstimmungen. Keine externen Abhängigkeiten.
Workflow-Orchestrierung
Deklarative JSON-basierte Arbeitsablauf-Engine für wiederholbare Multi-Step-Geräteoperationen. Unterstützt Variablenersetzung ({{pkg}}), Bedingungsschritte (if-Ausdrücke mit ==, !=, contains), Schleifen (repeat, bis 100 Iterationen) und die Erfassungen von Ergebnissen in Variablen für nachfolgende Schritte. Aktionen bilden direkt auf ADB-Bridge-Operationen ab, mit vollständiger Einhaltung der Sicherheits-Middleware. Die Workflow-Validierung erzwingt ein Maximum von 200 Schritten und ein Schlaf-Limit von 5 Minuten pro Schritt, um Ressourcenerschöpfung durch bösartigeoder fehlerhafte Workflow-Definitionen zu vermeiden.
Split-APK-Verwaltung
Unterstützung für moderne Android-Versandformate. Installiert App-Bundles über install-multiple, untersucht die Split-APKStruktur (Basis- und Konfigurations-Splits für Sprache, Dichte, ABI), extrahiert alle Splits zur lokalen Analyse und listet APEX-Module auf.
Geräte-Mirroring
Live-Screen-Mirroring über scrcpy-Integration. Unterstützt Fenster Modus für visuelles Feedback sowie Headless-Modus für rein Aufnahme-Workflows. Die Sitzungsverfolgung pro Gerät ermöglicht gleichzeitiges Spiegel mehrere verbundener Geräte. Prozessauflösungs-Handlerprozess verhindern verwaiste scrcpy-Prozesse.
Automatisierte Testgenerierung
Analysiert die Live-UI-Hierarchie und Paket-Intent-Registrierungen, um automatisch Test-Workflow-JSON zu generieren, das mit der Workflow-Orchestrierungs-Engine kompatibel ist. Die UI-basierte Generierung tippt jedes interaktive Element an, protokolliert Screenshots und prüft auf Abbrüche. Die Intent-basierte-Variante startet jede exportierte Aktivität mit einer Absturz-Erkennung.
OTA-Update-Überwachung
Erfasst einen umfassenden System-Figuren-Fingerabdruck (Build-ID, Android-Version, Sicherheitspatch-Stand, Bootloader, Basisband-Firmware, Kernel-Version, A/B-Partitions-Slot) über die Sitzungen hinweg. Diese vergleicht aktuelle Gerätesituation mitandenen Fingerabdrücken und sqrt zu erkennen assemblies OTA-Update. Identifiziert genau, welche Attribut geändert haben, und empfiehlt, nach einem Update die Codes für Performance-Metriken und Screenshots neu zu setzen.
RIL-Nachrichten-Erfassung
Erfassung von Radio-Interface-Layer-Nachrichten aus dem Android-Logcat-Ratio-Buffer persistent wiederholt. Startet einen Hintergrundprozess (d)plies in einem Ringpuffer. The buffer is persistiert dData from logcat-Radio, kategorisiert: Abbildung an ® we continue auf Wechsel. Startet einen Hintergrundprozess, der RIL-Nachrichten (ähn) sammelt und nach Registrierung, cell_info, signal, network, security, handover, data, radio_state, sms und NAS-Ereignisse engteilt.". ,-Abfall ist with Abruf per Polling with Kategoriefilter möglich.
session limit5 and cleanup handler prevent res exhaust. handy für passive Beobachtung von-Kommunikation zwischen Basisband undFramework zu Zwecken der Funkdiagnose und der Mobilfunkforschung. Die Sitzungsbegrenzung (5) und Prozessaufräum-Handler verhindern Ressourcenerschöpfung.
Geräteprofil-Bibliothek
Geräteprofilwissen mit Gerätehardwareidentifikation, Chip-Ebene – Chipidentifikation, Bekannte Modem-Knoten, AT-Kompatibilität, Root-Anforderungen, telefonischen Niemals-Nicht, Rufnummer Anforderungen, Doppel-SIM-Steckplatzerieze. Nummer-+ work button breite- Standard – erkennt automatisch von verbundn a propagates aktuellen Gerät software and katalog. Speichern profile Über Streamsop accumulator. Good for Tools such as adb_at_detect. Community-Erweiterung über gespeicherte Profildateien.
WebKit Replace-Transport
Eine Alternative zu stdio und HTTP/SSE für MCP-Clients, die von echter bidirektionaler Übertragung durchgehend profitieren. Niedrigere Latenz im Vergleich zum SSE-Polling bei besser Web-Framework-Kompatibilität. Erfordert das ws npm-Package als optionale Peer-Abhängigkeit. Setzen Sie DA_WS_PORT zum Aktivieren des Modus.
Modem-Firmware-Analyse
Umfassende Multi-Komponenten-Firmware-Identifikation, -Vergleich und -Verlaufsverfolgung. Analysiert Basisband-Versionsstrings für 6 Chipsatz-Familien: Shannon/Exynos (einschließlich Google Pixel/Tensor g5123b-*-Format und klassischem Samsung S5123AP_CL*-Format), Qualcomm MPSS-Zweig/-Version/-Build, MediaTek MOLY-Zweig/-Release/-Meilenstein, Unisoc/Spreadtrum SoC-Modell/-Version, HiSilicon/Kirin-Modell/-Carrier-Code und Intel XMM-Modell/-Zweig. Analysiert außerdem Bootloader-Versionen (Pixel-Codename/-Version/-Build, Samsung-Modell/-Carrier/-Revision) und RIL-Implementierungsstrings (Samsung S.LSI-Anbieter/-ID/-API/-Build-Datum, Qualcomm, MediaTek). Die Firmware-Sonde meldet 8 Abschnitte: Basisband, Bootloader, RIL, Kernel, Sicherheit/Build, Partition/Boot (A/B-Slot, Secure Boot, Verified Boot, Flash-Sperre), VBMeta-Integrität und OTA-Partitionsinventar. Das Diff-Tool vergleicht alle Firmware-Komponenten zwischen gespeicherten Fingerprints oder dem Live-Gerätezustand, mit tiefen geparsten Sub-Diffs für Basisband und Bootloader. Das Verlaufs-Tool verfolgt die Multi-Komponenten-Firmware-Entwicklung über OTA-Fingerprints hinweg.
Workflow-Marketplace
Community-Freigabeebene für die Workflow-Orchestrierungs-Engine. Durchsuchen Sie eine Registry mit von der Community beigesteuerten Test-Workflows, Diagnosesequenzen und Audit-Verfahren. Laden Sie Workflows direkt herunter und installieren Sie sie für die sofortige Ausführung mit adb_workflow_run. Exportieren Sie lokale Workflows mit Marketplace-Metadaten und automatisch generierten Registry-Manifesteinträgen zur Einreichung. SHA-256-Integritätsprüfung beim Download.
GraphQL-API
Optionaler HTTP-Endpunkt, der eine GraphQL-API für zusammengesetzte Geräteabfragen bereitstellt. Ermöglicht Clients, Geräteinformationen, Akku, Netzwerk und beliebige Eigenschaften in einer einzigen Anfrage abzurufen, anstatt mehrerer MCP-Tool-Aufrufe. POST-Anfragetext auf 1 MB begrenzt. Geräteeigenschaften werden einmal pro Auflösung vorab abgerufen, um Subprozess-Aufrufe zu minimieren. Erfordert das graphql-npm-Paket als optionale Peer-Abhängigkeit. Setzen Sie DA_GRAPHQL_PORT, um es zu aktivieren.
SELinux- und Berechtigungs-Audit
Prüft den SELinux-Erzwingungsmodus, fragt AVC-Ablehnungen aus logcat- und Kernel-Audit-Protokollen ab und prüft Laufzeit-Berechtigungserteilungen pro Paket. Gruppiert erteilte Berechtigungen nach gefährlicher Kategorie (Kamera, Standort, Telefon, SMS usw.) und kennzeichnet hochsensible Erteilungen wie Hintergrund-Standort und manage-external-storage. Erweitert die Sicherheits-Audit-Abdeckung auf die OS-Berechtigungsebene.
Thermal- und Strom-Profilierung
Erfasst Thermal-Zonen-Temperaturen aus sysfs, Frequenzskalierungszustände und -Governors pro CPU, Kühlgeräteaktivität und Akku-Entladeraten. Ergänzt die Regressionserkennung mit Thermal-/Strom-Basislinien für Probleme, die sich als Hitze oder Akku-Entladung äußern, anstatt als Frame-Drops. Enthält zeitgesteuerte Entlademessung mit mA/mW/geschätzten-%-pro-Stunde-Berechnungen.
Netzwerk-Geräteerkennung
Scannt das lokale Netzwerk nach ADB-fähigen Geräten über ARP-Tabellenabfragen und optionale IP-Bereichs-Sweeps. Testet gängige ADB-Ports (5555-5558) mit gebündelten parallelen TCP-Verbindungsversuchen. Extrahiert Geräte-WiFi-IPs über mehrere Methoden. Der Auto-Connect-Modus erkennt und verbindet Geräte in einem Schritt. Optimiert drahtlose Debugging-Workflows.
QEMU/KVM-Virtualisierung
Verwaltung virtueller Maschinen auf dem Gerät mit QEMU und KVM-Hardwarebeschleunigung. Ermöglicht das Ausführen von Android-Gast-VMs direkt auf dem physischen Gerät — eine Fähigkeit, die DeepADB einzigartig macht. Die dynamische Ressourcenzuweisung erkennt automatisch Host-CPU-Kerne und physischen RAM und reserviert 1 Kern und 35 % des Speichers für das Host-Betriebssystem, um Verhungern zu verhindern. Multi-VM-Unterstützung verfolgt den Ressourcenverbrauch über gleichzeitige VMs und lehnt neue VMs ab, wenn der Pool erschöpft ist, anstatt die Host-Leistung zu beeinträchtigen. Festplatten-Image-Verwaltung mit qcow2 (sparse, snapshot-fähig) und raw-Formaten. ADB-Portweiterleitung zu Gast-VMs ermöglicht es der vollständigen DeepADB-Tool-Suite, gleichzeitig Host- und Gast-Geräte anzusprechen. Prozesslebenszyklus wird über die zentrale Bereinigungs-Registry mit SIGTERM/SIGKILL-Beendigung verfolgt. Pfad-Containment-Prüfung bei allen Image-Operationen verhindert Directory Traversal.
ToolContext-Architektur
Alle 45 Tool-Module erhalten ein einheitliches ToolContext-Abhängigkeitsbündel, das Server, Bridge, deviceManager, Logger, Sicherheit und Konfiguration enthält. Das Hinzufügen neuer querschnittlicher Abhängigkeiten erfordert keine Änderungen an Modulsignaturen.
Umgebungsvariablen
Variable | Standard | Beschreibung |
| Automatische Erkennung | Erzwingt den On-Device-Modus ( |
| Automatische Erkennung | Pfad zur ADB-Binärdatei (im On-Device-Modus ignoriert) |
|
| Standard-Befehlstimeout in Millisekunden |
|
| Maximale Ausgabezeichen vor Kürzung |
|
| Maximale Logcat-Zeilen pro Snapshot |
| (automatisch) | Standard-Geräteseriennummer (wählt automatisch aus, wenn nur ein Gerät vorhanden ist) |
| OS-Temp | Temporäres Verzeichnis für Screenshots, gepullte Dateien, Bug-Reports, Testsitzungen und Snapshots |
|
| TTL des Gerätelisten-Caches in Millisekunden (0 = deaktiviert) |
|
| Anzahl der Wiederholungsversuche bei vorübergehenden ADB-Fehlern |
|
| Basis-Wiederholungsverzögerung in ms (verdoppelt sich bei jedem Versuch) |
|
| Log-Level: debug, info, warn, error |
| (automatische Erkennung) | Auf |
|
| MCP-Resource-Cache-TTL in ms. Auf einen positiven Wert setzen, um Ressourcen-Lesezugriffe (device://info, device://battery, usw.) für diese Dauer zu cachen. |
|
| Speicherstamm für tempdir-gestützte Tool-Ergebnishandles. Überschreiben, um den Speicher aus dem Standard-Temp-Verzeichnis zu verlagern. |
|
| TTL pro Handle in Sekunden. Handles, die älter als dieser Wert sind, werden beim Start-Sweep und bei der periodischen Räumung entfernt. Begrenzt auf [60, 7 Tage]. |
|
| Größenlimit pro Handle. Tools, die versuchen, einen Inhaltsblock zu speichern, der größer als dieser Wert ist, schlagen mit einem Fehler fehl. |
|
| Gesamtgrößenlimit des Ergebnis-Handle-Speichers über alle Handles. Löst bei Überschreitung LRU-Räumung aus. |
|
| Maximale Anzahl aktiver Handles. Löst bei Überschreitung LRU-Räumung aus. |
|
| Sicherheits-Middleware aktivieren (Befehlsfilterung, Ratenbegrenzung) |
| (keine) | Kommagetrennte Liste blockierter Shell-Befehls-Teilstrings |
| (keine) | Kommagetrennte Zulassungsliste (falls gesetzt, werden nur passende Befehle ausgeführt) |
|
| Maximale Befehle pro Minute (0 = unbegrenzt) |
|
| Netzwerkerreichbarkeitsziel, das von |
|
| Protokolliert alle ausgeführten Befehle für die Audit-Trail (auf |
|
| Verzeichnis, das beim Start nach Plugin-.js-Modulen durchsucht wird |
| GitHub-Standard | URL des JSON-Manifests der Community-Plugin-Registry |
| (deaktiviert) | Auf eine Portnummer setzen, um den HTTP/SSE-Transportmodus zu aktivieren |
|
| Bindungsadresse für HTTP/SSE-, WebSocket- und GraphQL-Server |
| (keine — offen) | Bearer-Token für Netzwerktransporte. Wenn gesetzt, erfordern alle HTTP/SSE/WS/GraphQL-Anfragen den Header |
| (keine — verweigern) | Erlaubte CORS-Origin für HTTP/SSE |
| (deaktiviert) | Auf eine Portnummer setzen, um den WebSocket-Transportmodus zu aktivieren (erfordert |
| (keine — verweigern) | Erlaubte CORS-Origin für den WebSocket-Health-Endpunkt |
| (deaktiviert) | Auf eine Portnummer setzen, um den GraphQL-API-Endpunkt zu aktivieren (erfordert |
| (keine — verweigern) | Erlaubte CORS-Origin für die GraphQL-API |
| (abgeleitet von DA_REGISTRY_URL) | URL des JSON-Manifests des Workflow-Marktplatzes |
| (keine) | Numerische PIN, die von |
Projektstruktur
DeepADB/
├── src/
│ ├── index.ts # Entry point — stdio, HTTP/SSE, WebSocket, or GraphQL transport
│ ├── server.ts # MCP server wiring, config, module registration (exports CreateServerResult)
│ ├── http-transport.ts # HTTP/SSE transport server for browser clients
│ ├── ws-transport.ts # WebSocket transport (optional `ws` peer dependency)
│ ├── graphql-api.ts # GraphQL API endpoint (optional `graphql` peer dependency)
│ ├── tool-context.ts # Unified dependency bundle (ToolContext interface)
│ ├── bridge/
│ │ ├── adb-bridge.ts # Core ADB subprocess wrapper, retry logic, error types
│ │ ├── local-bridge.ts # On-device direct execution bridge with privilege escalation (Termux/local mode)
│ │ └── device-manager.ts # Device discovery, TTL cache, serial routing
│ ├── tools/
│ │ ├── health.ts # Toolchain health check (1 tool)
│ │ ├── device.ts # Device info and properties (3 tools)
│ │ ├── shell.ts # Shell and root command execution (2 tools)
│ │ ├── packages.ts # App lifecycle, install, permissions, intents (12 tools)
│ │ ├── files.ts # File operations — push, pull, write, find, grep, replace, stat, checksum, chmod, chown, touch, fsinfo (18 tools)
│ │ ├── logs.ts # Logcat snapshots — filtered (3 tools)
│ │ ├── logcat-watch.ts # Persistent logcat with ring buffer and poll (4 tools)
│ │ ├── diagnostics.ts # dumpsys, telephony, battery, network, perf, bugreport, crash logs, heap dump (9 tools)
│ │ ├── ui.ts # Screenshots, input, activity, UI hierarchy, annotated screencap, screen state (8 tools)
│ │ ├── input-gestures.ts # Drag, long press, double tap, text, URL, orientation, clipboard, tap-element, wait-element, wait-stable, scroll-until, compressed screenshot, batch actions, fling, pinch, screen size, device state, notifications (18 tools)
│ │ ├── screen-record.ts # Screen video recording start/stop (2 tools)
│ │ ├── control.ts # Airplane, WiFi, data, location, screen, settings, reboot (9 tools)
│ │ ├── wireless.ts # WiFi pairing, connect, disconnect, TCP/IP (4 tools)
│ │ ├── forwarding.ts # Port forwarding — forward, reverse, list, remove, managed tunnels with auto-port-pick (8 tools)
│ │ ├── emulator.ts # AVD list, start, stop with on-device KVM/QEMU detection (3 tools)
│ │ ├── qemu.ts # QEMU/KVM VM management — setup, images, start, stop, status, guest ADB connect/disconnect/shell (8 tools)
│ │ ├── testing.ts # Structured test sessions with numbered steps (3 tools)
│ │ ├── multi-device.ts # Multi-device shell, install, compare, comparative testing (4 tools)
│ │ ├── snapshot.ts # Device state capture, compare, restore (3 tools)
│ │ ├── network-capture.ts # tcpdump start/stop, network connections (3 tools)
│ │ ├── ci.ts # CI wait-boot, device-ready, run-tests (3 tools)
│ │ ├── plugins.ts # Plugin loader, info, and dynamic tool loading (2 tools)
│ │ ├── baseband.ts # Modem/baseband inspection and radio diagnostics (6 tools)
│ │ ├── accessibility.ts # Automated WCAG accessibility auditing (3 tools)
│ │ ├── regression.ts # Performance baseline and regression detection (3 tools)
│ │ ├── device-farm.ts # Firebase Test Lab integration via gcloud (3 tools)
│ │ ├── registry.ts # Community plugin registry search/install (3 tools)
│ │ ├── at-commands.ts # AT command modem interface, multi-chipset, cross-validation (5 tools)
│ │ ├── screenshot-diff.ts # Visual regression — screenshot baseline/diff (3 tools)
│ │ ├── workflow.ts # Declarative workflow orchestration engine (3 tools)
│ │ ├── split-apk.ts # App bundles, split APKs, APEX modules (4 tools)
│ │ ├── mirroring.ts # Live screen mirroring via scrcpy (3 tools)
│ │ ├── test-gen.ts # Automated test workflow generation (3 tools)
│ │ ├── ota-monitor.ts # OTA update monitoring and fingerprinting (3 tools)
│ │ ├── ril-intercept.ts # RIL message interception from radio buffer (3 tools)
│ │ ├── device-profiles.ts # Device profile library with built-in entries (3 tools)
│ │ ├── firmware-analysis.ts # Modem firmware version parsing and diffing (3 tools)
│ │ ├── workflow-market.ts # Workflow marketplace — search, install, export (3 tools)
│ │ ├── selinux-audit.ts # SELinux status, AVC denials, permission auditing (3 tools)
│ │ ├── thermal-power.ts # Thermal zones, CPU frequency, battery drain (3 tools)
│ │ ├── network-discovery.ts # ADB-over-network scanning and auto-connect (3 tools)
│ │ ├── sensors.ts # Hardware sensor enumeration, IIO power monitor reading (2 tools)
│ │ ├── result-handles.ts # Tempdir-backed result handle store — list, drop, drop-all (3 tools) + the result://{tool}/{name} resource
│ │ ├── wireless-firmware.ts # WiFi, Bluetooth, NFC, GPS firmware identification (4 tools)
│ │ ├── build.ts # Gradle build and install (2 tools)
│ │ ├── resources.ts # MCP Resources — 4 device-state surfaces: device://info|battery|telephony|list (5th, result://, lives in result-handles.ts)
│ │ └── prompts.ts # MCP Prompts — workflow templates (4 prompts)
│ ├── middleware/
│ │ ├── auth.ts # Bearer token authentication for network transports (DA_AUTH_TOKEN)
│ │ ├── output-processor.ts # Contextual truncation, structured parsers, settledValue helper
│ │ ├── security.ts # Command filtering, rate limiting, audit logging with redaction
│ │ ├── sanitize.ts # Shell injection prevention — validateShellArg/validateShellArgs/shellEscape
│ │ ├── chipset.ts # Shared chipset family detection, modem path mapping, SIM config detection
│ │ ├── fetch-utils.ts # Shared HTTP helpers with 5 MB streaming response size limit
│ │ ├── png-utils.ts # Zero-dependency PNG decode/encode/draw primitives for screenshot annotation and diffing
│ │ ├── ui-dump.ts # Shared uiautomator XML capture with concurrent-safe paths, on-device /data/local/tmp routing, and cleanup
│ │ ├── cleanup.ts # Centralized process cleanup registry for SIGINT/SIGTERM/exit
│ │ ├── logger.ts # stderr-safe logging (MCP-compliant)
│ │ ├── fs-utils.ts # Filename sanitization, atomic write, private-dir helpers, within-dir containment check
│ │ ├── parse-utils.ts # Shared parseIntSafe for env-var numeric parsing (single source of truth)
│ │ └── result-handle.ts # Tempdir-backed tool result content cache with TTL, LRU, and token-hash isolation
│ └── config/
│ └── config.ts # Configuration, env vars, startup validation
├── package.json
├── tsconfig.json
├── server.json # MCP Registry metadata (io.github.fullread/deepadb)
├── .gitignore
├── README.md
├── SECURITY.md # Threat model, security architecture, deployment hardening, vulnerability reporting
├── CHANGELOG.md # Version history from v0.1.0 to current
├── LICENSE # Apache 2.0 license
└── tests/
├── run-all.mjs # Run all test suites sequentially with summary (tracks skipped counts)
├── test-hw.mjs # Hardware core: health, identity, baseband, thermal, profiles, wireless firmware, crash analysis (34 tests)
├── test-shell-files.mjs # Shell, filesystem, packages, diagnostics (24 tests)
├── test-ui-control.mjs # UI hierarchy, screenshots, settings, input gestures, UI automation, device awareness, accessibility, screen lock/unlock, multi-touch (46 tests)
├── test-monitoring.mjs # Logcat watchers, snapshots, OTA, regression, workflows (43 tests)
├── test-security.mjs # Input sanitization, shell injection, AT command safety, QEMU shell escaping, heap-dump validation (116 on-device, 105 host)
├── test-lifecycle.mjs # App lifecycle, file push/pull, input, port forwarding, screen recording, test sessions (24 tests)
├── test-analysis.mjs # Thermal/snapshot/regression comparison, firmware diff, screenshot diff, test gen, RIL intercept, AT cross-validation, permission management (23 tests)
├── test-boundaries.mjs # Zod bounds enforcement, input injection, error paths, sensitive data protection, wireless ADB coverage, multi-device basics, tunnel automation, device-free coverage boundaries (78 tests)
├── test-sensors.mjs # HAL sensors, IIO power monitors, category filters, formatting, wake-up, rate display (30 tests)
├── test-files-extended.mjs # File tool coverage — write, find, stat, checksum, mkdir, rm, move, copy, chmod, touch, fsinfo, chown, grep, replace; push safety; sed-escape regression (95 tests)
├── test-result-handles.mjs # Result handle store — listing, retrieval, drop, isolation, eviction (19 tests)
├── test-qemu.mjs # QEMU/KVM setup, image management, VM status, guest connectivity errors (13 on-device tests)
├── test-qemu-boot.mjs # QEMU Alpine VM boot with auto-fetch of kernel/initrd, KVM acceleration, topology detection, guest ADB connectivity (17 on-device tests)
├── test-supply-chain.mjs # Supply-chain hardening checks for fetch and network paths (24 tests)
├── test-sanitize-fuzz.mjs # Property-based fuzzing of shell sanitizers — shellQuote/shellEscape round-trip, validateShellArg rejection (19 tests)
├── test-transports.mjs # Transport smoke — HTTP/SSE + WebSocket MCP round-trip, GraphQL health query (8 tests)
└── lib/
└── harness.mjs # Shared test harness (stdio JSON-RPC transport, assertion primitives)Tech-Stack
Runtime: Node.js ≥22 (ES2024, ESM; Node 22.12+ für Testabdeckung)
Sprache: TypeScript 6.0 (Strict-Modus, NodeNext-Modulauflösung)
MCP SDK:
@modelcontextprotocol/sdk^1.24.0 (derzeit auf 1.30.0 aufgelöst)Validierung: Zod ^4.4.3
Transport: stdio (JSON-RPC), HTTP/SSE, WebSocket (optional
ws), GraphQL API (optionalgraphql)
Lizenz
Apache License 2.0 — siehe LICENSE und NOTICE. Das Release v1.1.2 wurde von MIT zu Apache 2.0 migriert, um die Anforderungen an eine ausdrückliche Patenterteilung und die Namensnennung von Mitwirkenden zu erfüllen; bestehende Forks/Installationen bleiben unter den bisherigen MIT-Bedingungen gültig.
Available Tools
209 toolsadb_a11y_auditA
Run an automated accessibility audit on the current screen. Checks for: missing labels on interactive elements, undersized touch targets (<48dp), images without content-descriptions, clickable elements missing focusability, and duplicate descriptions. Returns a structured report with severity and rule violations.
Inputs: device.
adb_a11y_touch_targetsB
List all interactive elements with their touch target dimensions in dp. Highlights elements below the 48dp minimum. Useful for quickly identifying cramped UI layouts.
Inputs: device, belowMinOnly.
adb_a11y_treeA
Dump the accessibility-focused view of the UI hierarchy. Shows only elements relevant to screen readers: their roles, labels, states, and navigation order. Filters out decorative/layout containers.
Inputs: device.
adb_airplane_cycleA
Cycle airplane mode on then off after a delay. Forces cellular re-registration — useful for radio diagnostics and network testing.
Inputs: device, delaySeconds.
adb_airplane_modeB
Toggle airplane mode on/off. Useful for resetting cellular registration during radio testing.
Inputs: enabled (required), device.
adb_apex_listA
List installed APEX modules on the device. APEX (Android Pony EXpress) modules deliver updatable system components. Shows module name, version, and active/staged status.
Inputs: device.
adb_app_route_contextA
Show the effective Android routing context for one installed app by correlating its UID with ip rules, route tables, network policy, VPN, and default-network state. Read-only; does not alter routes or app policy.
Inputs: packageName (required), device, includeConnectivitySummary.
adb_at_batchB
Send multiple AT commands sequentially and capture all responses. Useful for running a diagnostic sequence. Requires root.
Inputs: commands (required), port, force, device, +2 more.
adb_at_cross_validateA
Cross-validate baseband firmware by comparing AT command responses (direct modem interrogation) against Android system properties (getprop). Discrepancies may indicate firmware tampering, incomplete OTA updates, or property spoofing. Sends ATI (identification), AT+CGMR (firmware revision), and AT+CGMM (model) to the modem and compares with gsm.version.baseband, ro.hardware.chipname, and related properties. Requires root.
Inputs: port, device, timeout.
adb_at_detectA
Auto-detect the modem AT command device node. Identifies the chipset family (Shannon, Qualcomm, MediaTek, Unisoc) and probes known device node paths. Requires root. Returns the first responding node.
Inputs: device.
adb_at_probeA
Run a standard AT diagnostic probe: modem identification, signal quality, network registration, SIM status, and supported bands. Requires root.
Inputs: port, device.
adb_at_sendA
Send a single AT command to the modem and capture the response. Requires root. Use adb_at_detect to find the correct port, or specify it manually.
Inputs: command (required), port, force, device, +1 more.
adb_avd_listB
List all available Android Virtual Devices (AVDs) that can be started.
Inputs: no named parameters.
adb_baseband_infoC
Get comprehensive modem/baseband identification: firmware version, RIL implementation, chipset, IMEI, SIM state, and radio capabilities.
Inputs: device, includeImei, result_handle, result_handle_ttl.
adb_batch_actionsB
Execute multiple input actions in a single tool call. Reduces ADB round-trips for multi-step UI interactions. Each action runs sequentially with an optional delay between them. Supported action types: tap, swipe, fling, long_press, double_tap, keyevent, text, drag, pinch, back, home, sleep.
Inputs: actions (required), device, delayMs, stopOnError.
adb_batteryB
Get battery status, level, temperature, and charging info
Inputs: device.
adb_battery_drainA
Measure battery drain rate over a specified duration. Takes initial and final readings and calculates mA draw, mW power consumption, and estimated percentage per hour. Useful for profiling power impact of specific operations.
Inputs: device, durationMs, packageName.
adb_bluetooth_firmwareA
Bluetooth firmware and chipset identification. Reports firmware version, BT version (4.x/5.x), chipset model, adapter state, supported profiles, LE capabilities, and bonded device count. MAC address and device name are opt-in only (permanent identifiers).
Inputs: device, maxLines, includeIdentifiers.
adb_bugreportA
Capture a full bug report zip (device state, logs, dumpsys, system info). Returns the local file path.
Inputs: device.
adb_build_and_installB
Build a debug APK and install it on the connected device (convenience wrapper)
Inputs: projectPath (required), device, timeout.
adb_carrier_configB
Dump carrier configuration values. Useful for verifying carrier settings, detecting configuration anomalies, and inspecting APN configurations.
Inputs: device.
adb_catC
Read a text file from the device
Inputs: path (required), device, maxLines.
adb_cell_identityB
Extract detailed cell identity information: Cell ID (CID), TAC/LAC, EARFCN/ARFCN, Physical Cell ID (PCI), PLMN, and network type. Parses structured data from dumpsys for cellular network analysis.
Inputs: device.
adb_ci_device_readyA
Comprehensive CI readiness check. Verifies: device online, booted, package manager ready, screen unlocked, network available. Returns structured pass/fail results.
Inputs: device.
adb_ci_run_testsA
Run Android instrumented tests (androidTest) via am instrument and capture results. Returns structured pass/fail output.
Inputs: testPackage (required), device, runner, timeout, +2 more.
adb_ci_wait_bootB
Wait for a device or emulator to fully boot. Polls sys.boot_completed and waits for the launcher to be ready. Essential for CI pipelines.
Inputs: device, timeoutSeconds.
adb_clear_dataA
Clear all data for a package (equivalent to clearing storage in settings). DESTRUCTIVE — irreversibly wipes all app data, cache, databases, shared preferences, and login state. AP5 fix: requires confirm: <packageName> to proceed.
Inputs: packageName (required), device, confirm.
adb_clipboardA
Read or write the device clipboard. Write mode sets the clipboard content; read mode retrieves it. Clipboard access requires Android 10+ and may need the app to be in foreground on Android 12+.
Inputs: action (required), text, device.
adb_connectA
Connect to a device over WiFi/TCP. Device must be paired first or have TCP/IP enabled.
Inputs: host (required).
adb_crash_logsA
Read ANR (Application Not Responding) traces and tombstone crash dumps from the device. Requires root access for /data/anr/ and /data/tombstones/. Returns the most recent entries.
Inputs: type, device, maxEntries.
adb_current_activityB
Get the currently focused activity and window stack
Inputs: device.
adb_device_infoB
Get detailed properties for a connected device (model, OS version, build, etc.)
Inputs: device.
adb_devicesA
List all connected Android devices with their state, model, and product info
Inputs: no named parameters.
adb_device_stateA
Get a combined device state snapshot in one call: battery level/status, network connectivity, screen on/off, foreground activity, and orientation. Useful as a pre-check before UI automation or as a quick device health summary.
Inputs: device.
adb_disconnectA
Disconnect from a wireless device, or all wireless devices if no host specified
Inputs: host.
adb_dumpsysB
Run dumpsys for a specific service. Use 'list' as the service to see all available services.
Inputs: service (required), args, device, result_handle, +1 more.
adb_emulator_startB
Launch an Android Virtual Device (AVD) emulator. Returns once the emulator process has started.
Inputs: avdName (required), gpuMode, coldBoot, headless.
adb_emulator_stopB
Stop a running emulator. Uses 'adb emu kill' for graceful shutdown.
Inputs: device, avdName.
adb_extract_apksB
Pull all APK splits for a package from the device to a local directory. Useful for analysis, backup, or transfer to another device.
Inputs: packageName (required), device, outputDir.
adb_farm_matrixA
List available device models and API levels on Firebase Test Lab. Use to plan test matrices.
Inputs: type.
adb_farm_resultsA
Retrieve results from the most recent Firebase Test Lab run, or a specific test matrix ID. Shows pass/fail status, device results, and links to logs and artifacts.
Inputs: matrixId.
adb_farm_runB
Run tests on Firebase Test Lab. Uploads an APK and test APK, executes instrumented tests across specified device models and API levels. Requires gcloud CLI authenticated with a Firebase project.
Inputs: appApk (required), testApk (required), devices, timeout, +3 more.
adb_file_checksumA
Compute SHA-256 hash of a file on the device. Critical for firmware integrity verification, tamper detection, and comparing files across devices. Read-only operation. Reports file size alongside the hash.
Inputs: path (required), root, device, algorithm.
adb_file_chmodA
Change file permissions on the device. Mode must be a valid octal string (e.g., '755', '644', '600'). Recursive mode uses depth-based protection: refuses at depth ≤ 2 from root. Note: sdcardfs/FUSE ignores Unix permissions — file access on /sdcard is controlled by Android's package ownership model.
Inputs: mode (required), path (required), root, device, +1 more.
adb_file_chownA
Change file ownership on the device. Requires root. Supports both numeric UID:GID (e.g., '10150:10150') and symbolic user:group (e.g., 'system:system'). Recursive mode uses depth-based protection: refuses at depth ≤ 2 from root. Note: sdcardfs/FAT32 ignore ownership changes.
Inputs: path (required), owner (required), device, recursive.
adb_file_copyB
Copy a file or directory on the device. Pre-flight checks source size against destination available space. Post-verifies the copy by comparing file sizes. For recursive directory copies, use -r flag.
Inputs: source (required), destination (required), root, device, +1 more.
adb_file_fsinfoA
Report filesystem details for any path: filesystem type, mount point, mount options, capacity, usage, read-only status, permission support, symlink support, max file size, timestamp resolution, encryption status, and SELinux context. Essential for understanding what operations are possible before attempting them.
Inputs: path (required), root, device.
adb_file_moveA
Move or rename a file/directory on the device. Moving FROM a system path is destructive — source depth protection refuses if source is at depth ≤ 1 from root. Symlinks resolved before checks. Cross-filesystem moves (e.g., /data → /sdcard) do a copy+delete internally and can be slow for large files.
Inputs: source (required), destination (required), root, device.
adb_file_replaceB
Find and replace text in a file on the device. Uses sed internally with proper escaping — exposes a safe interface without requiring sed syntax knowledge. Supports global replacement, line-targeted edits, and optional backup creation. Reports match count.
Inputs: find (required), path (required), replace (required), root, +4 more.
adb_file_statA
Get detailed file metadata: size, permissions, ownership, timestamps (access/modify/change), SELinux security context, and file type. Read-only operation.
Inputs: path (required), root, device.
adb_file_touchA
Create an empty file or update timestamps. Three modes: create (touch non-existent path), update (set atime/mtime to now), or set explicit timestamp. On FAT32, timestamps have 2-second resolution. On tmpfs, timestamps are volatile.
Inputs: path (required), root, device, timestamp.
adb_file_writeA
Create or overwrite a text file on the device. Content is delivered via shell heredoc — suitable for config files, scripts, test fixtures, and small data files. For large or binary files, use adb_push instead. Shell buffer limits content to approximately 128KB.
Inputs: path (required), content (required), root, append, +1 more.
adb_findA
Search for files on the device by name or pattern. Uses the find command with glob matching. Results are capped at maxResults to prevent unbounded output. Reports whether results were truncated.
Inputs: name (required), root, type, device, +5 more.
adb_firmware_diffA
Compare all firmware components between two saved OTA fingerprints, or between the current device state and a saved fingerprint. Compares baseband (with chipset-specific parsed component diffs), bootloader, kernel, security patch, build ID, and Android version.
Inputs: to, from, device, result_handle, +1 more.
adb_firmware_historyB
Show firmware version progression across all saved OTA fingerprints for a device. Tracks baseband, bootloader, kernel, security patch, and build ID changes between consecutive snapshots with parsed component diffs.
Inputs: device.
adb_firmware_probeA
Comprehensive firmware identification for the connected device. Reports all firmware components: baseband (parsed by chipset family — Shannon, Qualcomm, MediaTek, Unisoc, HiSilicon, Intel), bootloader, RIL implementation, kernel, security patch, A/B slot, verified boot state, and OTA-updatable partitions.
Inputs: device.
adb_force_stopB
Force-stop an app immediately. The most common debugging action.
Inputs: packageName (required), device.
adb_forwardB
Forward a local port to a port on the device (host → device). Use for connecting to services running on the device.
Inputs: local (required), remote (required), device.
adb_forward_listB
List all active port forwards and reverse forwards
Inputs: device.
adb_forward_removeA
Remove a port forward (host → device), or all forwards. Use after testing to clean up.
Inputs: local, device.
adb_getpropA
Get a specific Android system property, or all properties if no key given
Inputs: key, device.
adb_gps_firmwareB
GNSS/GPS chipset and firmware identification. Reports GNSS hardware model (manufacturer, chip, firmware version), supported constellations (GPS, GLONASS, Galileo, BeiDou, QZSS, NavIC, SBAS), signal types with frequencies, dual-frequency (L1+L5) support, raw measurement capabilities (pseudorange access for spoofing detection), A-GPS modes (MSB/MSA — cellular-routed assisted GPS relevant to IMSI catcher research), carrier phase measurements, navigation message decoding, and SUPL server configuration.
Inputs: device.
adb_gradleC
Run a Gradle task in an Android project directory
Inputs: task (required), projectPath (required), args, timeout.
adb_grant_permissionC
Grant a runtime permission to a package
Inputs: permission (required), packageName (required), device.
adb_grepA
Search file contents on the device by text pattern. Uses fixed-string matching by default (no regex injection risk). Supports recursive directory search with depth control and result capping. For filename searches, use adb_find instead.
Inputs: path (required), pattern (required), root, device, +8 more.
adb_health_checkA
Run a comprehensive health check of the ADB toolchain. Validates: ADB binary, server, device connection, authorization, and root access.
Inputs: device.
adb_heap_dumpA
Capture a heap dump from a running process for memory analysis. Triggers am dumpheap and pulls the resulting .hprof file. Requires the target process PID or package name.
Inputs: target (required), device, filename.
adb_iio_readA
Read raw hardware data from the Linux IIO (Industrial I/O) subsystem. Discovers all IIO devices and reads their current values. On Tensor/Exynos devices, this exposes per-rail power monitors (ODPM) showing real-time power consumption per SoC subsystem (CPU clusters, GPU, display, memory, TPU, GPS, etc.) — data not available through the Android sensor HAL. On other devices, may expose raw accelerometer, gyroscope, magnetometer, or ADC channels. Root required.
Inputs: device, listOnly.
adb_inputC
Send input events to the device (tap, swipe, text, keyevent)
Inputs: args (required), type (required), device.
adb_input_double_tapA
Double tap at a point on screen. Triggers zoom, text selection, or double-tap gestures. Two rapid taps with a configurable interval.
Inputs: x (required), y (required), device, intervalMs.
adb_input_dragA
Drag from one point to another on screen. Uses Android's draganddrop input command. Useful for drag-and-drop UI elements, sliders, map panning, and reorder operations.
Inputs: x1 (required), x2 (required), y1 (required), y2 (required), +2 more.
adb_input_flingA
Perform a high-velocity fling gesture. Like swipe but with a short duration to create scroll momentum on lists, launchers, and paged views. Useful for fast-scrolling through long lists, dismissing notifications, or triggering velocity-sensitive behaviors.
Inputs: x1 (required), x2 (required), y1 (required), y2 (required), +2 more.
adb_input_long_pressA
Long press at a point on screen. Triggers context menus, selection mode, drag handles, and other long-press behaviors. Implemented as a zero-distance swipe with configurable hold duration.
Inputs: x (required), y (required), device, durationMs.
adb_input_pinchA
Perform a multi-touch pinch (zoom out) or spread (zoom in) gesture. Two fingers move symmetrically toward or away from a center point. Uses parallel swipe injection by default (universal, no root); when root is available, can use raw sendevent for true multi-touch MT protocol injection. The 'auto' method selects the best available approach.
Inputs: cx (required), cy (required), endRadius (required), startRadius (required), +5 more.
adb_input_textA
Type text on the device. Handles special characters by converting spaces to %s and escaping shell metacharacters. For multi-line or complex text, consider using the clipboard tool instead.
Inputs: text (required), device.
adb_installB
Install an APK on the device. Provide the full local path to the APK file.
Inputs: apkPath (required), device, replace, downgrade.
adb_install_bundleB
Install multiple APK splits (app bundle) on the device using install-multiple. Provide all split APK files — base APK plus config splits (language, density, ABI).
Inputs: apkPaths (required), device, replace, allowDowngrade.
adb_list_packagesC
List installed packages. Supports filtering by name.
Inputs: type, device, filter.
adb_list_permissionsA
List permissions declared and granted for a package. Parses the package dump to show install-time and runtime permissions with their current grant state. Useful for auditing permission state before and after grant/revoke operations.
Inputs: packageName (required), device, filter.
adb_list_splitsA
List all APK split paths installed for a package. Shows the base APK and any configuration splits (language, screen density, ABI).
Inputs: packageName (required), device.
adb_locationC
Enable or disable location services
Inputs: mode (required), device.
adb_logcatB
Capture a logcat snapshot. Supports tag filtering, priority levels, and grep patterns.
Inputs: tag, grep, lines, buffer, +4 more.
adb_logcat_clearB
Clear all logcat buffers on the device
Inputs: device.
adb_logcat_crashC
Get recent crash logs from the crash buffer
Inputs: lines, device.
adb_logcat_pollA
Retrieve new logcat lines since the last poll from a running watcher session.
Inputs: session (required), maxLines, result_handle, result_handle_ttl.
adb_logcat_sessionsB
List all active logcat watcher sessions
Inputs: no named parameters.
adb_logcat_startA
Start a background logcat watcher. Lines accumulate in a ring buffer. Use adb_logcat_poll to retrieve new entries.
Inputs: tag, device, priority, bufferSize.
adb_logcat_stopC
Stop a running logcat watcher session
Inputs: session (required).
adb_lsC
List files and directories on the device
Inputs: path, device, details.
adb_market_exportA
Export a local workflow with marketplace metadata for sharing. Produces a JSON file with name, description, version, author, and tags suitable for submission to the marketplace registry.
Inputs: workflow (required), tags, author, version.
adb_market_installB
Download and install a workflow from the marketplace. Saves to the workflows directory for immediate use with adb_workflow_run.
Inputs: name (required), force.
adb_market_searchB
Search the workflow marketplace for community-shared workflow definitions. Shows name, description, tags, author, and step count. Indicates which workflows are already installed locally.
Inputs: tag, query.
adb_mirror_startB
Start live screen mirroring for a device using scrcpy. Requires scrcpy installed and on PATH. Supports windowed (visual) and headless (no display) modes. One session per device.
Inputs: device, maxFps, record, bitrate, +4 more.
adb_mirror_statusA
Check scrcpy availability and list active mirroring sessions.
Inputs: no named parameters.
adb_mirror_stopA
Stop an active scrcpy mirroring session for a device.
Inputs: device.
adb_mkdirC
Create a directory on the device. Supports -p flag for creating parent directories.
Inputs: path (required), root, device, parents.
adb_mobile_dataC
Enable or disable mobile data
Inputs: enabled (required), device.
adb_modem_logsB
Capture modem/baseband-related logs from multiple sources: RIL (Radio Interface Layer) logcat, telephony framework logs, and kernel modem messages via dmesg (root required for dmesg). Useful for radio diagnostics and tracing baseband-framework communication.
Inputs: grep, lines, device.
adb_multi_compareB
Run a command on all devices and compare outputs side by side. Highlights differences across devices.
Inputs: command (required), devices.
adb_multi_installB
Install an APK on multiple (or all) connected devices in parallel.
Inputs: apkPath (required), devices, replace.
adb_multi_shellA
Execute a shell command on multiple (or all) connected devices in parallel. Returns results grouped by device.
Inputs: command (required), devices, timeout.
adb_multi_testA
Run a comparative test workflow across all connected devices (host + QEMU guests). Executes a predefined diagnostic profile or custom command list on every device in parallel, compares results per-check, and reports matches and differences. Profiles: 'firmware' (baseband, bootloader, kernel, security patch), 'security' (SELinux, verified boot, encryption), 'network' (radio, WiFi, SIM), 'identity' (model, chipset, architecture), 'full' (all profiles). Custom commands also supported.
Inputs: devices, profile, timeout, commands.
adb_neighboring_cellsB
List all visible cells beyond the serving cell: neighboring LTE/5G/WCDMA/GSM cells with their identities and signal strengths. Useful for cellular network surveys, coverage analysis, and radio environment characterization.
Inputs: device.
adb_networkB
Get network connectivity info including WiFi, cellular, and active connections
Inputs: device.
adb_network_auto_connectA
Discover and automatically connect to ADB devices on the local network. Combines network scanning with adb connect in one step. Probes a single port (default 5555) on each candidate; if you need to cover the full ADB port range (5555-5558) use adb_network_scan first, then adb_connect with the discovered host:port.
Inputs: port, device, ipRange.
adb_network_connectionsB
Show active network connections on the device (TCP/UDP). Similar to netstat — shows established connections, listening ports, and connection states.
Inputs: device, protocol.
adb_network_device_ipA
Get the WiFi IP address of a connected device. Useful for switching from USB to wireless debugging without needing to find the IP manually on the device.
Inputs: device.
adb_network_scanA
Scan the local network for Android devices with ADB enabled over WiFi/TCP. Probes common ADB ports (5555-5558) on hosts from the ARP table and optionally a custom IP range. Discovered devices can be connected with adb_connect.
Inputs: ports, device, ipRange, timeoutMs.
adb_nfc_firmwareB
NFC controller firmware identification. Reports controller type (NXP/Broadcom/Samsung/ST), firmware version, NCI version, supported technologies (NFC-A/B/F/V), secure element availability (eSE/UICC), and HCE (Host Card Emulation) support.
Inputs: device, maxLines.
adb_notificationsB
Read active notifications on the device. Parses the notification manager dump to extract package, title, text, importance, channel, and flags for each notification. Useful for verifying push notification delivery, monitoring notification state, and testing notification-related features.
Inputs: device, filter, maxResults.
adb_open_urlA
Open a URL on the device in the default browser or handling app. Uses Android's VIEW intent action.
Inputs: url (required), device.
adb_orientationB
Get or set screen orientation. Can lock to portrait, landscape, reverse portrait, reverse landscape, or restore auto-rotate.
Inputs: action (required), device, orientation.
adb_ota_checkB
Compare the current system state against a saved fingerprint. Detects OTA updates by identifying changes in build ID, security patch, baseband firmware, bootloader, or kernel version.
Inputs: device, fingerprintPath.
adb_ota_fingerprintA
Capture and save the current system fingerprint: build ID, Android version, security patch, bootloader, baseband firmware, kernel version, and A/B partition slot. Saves to a timestamped JSON file for later comparison.
Inputs: label, device.
adb_ota_historyA
List all saved system fingerprints for a device, showing version progression over time. Highlights changes between consecutive snapshots.
Inputs: device.
adb_package_infoB
Get detailed info about an installed package (version, permissions, paths)
Inputs: packageName (required), device.
adb_pairA
Pair with a device over WiFi using the pairing code from Developer Options → Wireless debugging → Pair device
Inputs: code (required), host (required).
adb_perf_snapshotB
Capture a performance snapshot for a package: memory usage, frame stats, and CPU info in one call.
Inputs: packageName (required), device.
adb_permission_auditB
Audit runtime permission grants for a package. Lists all granted dangerous permissions grouped by category (Camera, Location, Phone, SMS, etc.) and flags potentially over-provisioned permissions. Compares grants against the dangerous permission manifest to identify unnecessary access.
Inputs: packageName (required), device.
adb_plugin_infoA
Show information about the plugin system: directory, how to create plugins, and loaded plugin count.
Inputs: no named parameters.
adb_plugin_listA
List all loaded plugins and the plugin directory path.
Inputs: no named parameters.
adb_profile_detectA
Auto-detect and build a device profile from the connected device. Captures hardware identification, chipset family, modem info, root status, and matches against the built-in profile library for known quirks.
Inputs: save, device.
adb_profile_listB
List all device profiles: built-in library entries and user-saved profiles.
Inputs: no named parameters.
adb_profile_saveA
Save a device profile to the profiles library. Use after adb_profile_detect to persist the profile, or create a manual profile with custom quirks and notes.
Inputs: name (required), profile (required).
adb_pullC
Pull a file from the device to local filesystem
Inputs: remotePath (required), device, localPath.
adb_pushB
Push a local file to the device filesystem. Pre-flight checks: hard-blocked kernel paths, filesystem type warnings, symlink resolution, and destination storage availability.
Inputs: localPath (required), remotePath (required), device.
adb_qemu_connectA
Connect to a running QEMU VM's ADB service, making the guest appear as a device for DeepADB tools. Requires the guest OS to have an ADB daemon running (e.g., Android guest with USB debugging enabled). Requires the 'adb' binary (install with: pkg install android-tools). Connections are restricted to localhost only — no remote host connections allowed.
Inputs: name (required), timeout.
adb_qemu_disconnectA
Disconnect from a QEMU VM's ADB service. Removes the guest from the device list.
Inputs: name (required).
adb_qemu_guest_shellA
Execute a shell command on a QEMU guest VM via ADB. The VM must be connected first (use adb_qemu_connect). The guest serial is derived internally — no user-supplied host/IP reaches the ADB binary. Subject to the same security middleware checks as adb_shell.
Inputs: name (required), command (required), timeout.
adb_qemu_imagesB
Manage QEMU disk images for virtual machines. List available images, create new qcow2/raw disk images, or delete existing ones. Images are stored in the DeepADB image directory.
Inputs: action (required), name, format, sizeMb.
adb_qemu_setupA
Check and install QEMU for on-device virtualization. Verifies KVM availability, checks if QEMU is installed, reports version info, and can install QEMU via Termux package manager. Only available in on-device mode.
Inputs: install.
adb_qemu_startA
Boot a QEMU virtual machine with KVM hardware acceleration. Auto-detects optimal resource allocation: uses total cores minus 1 for the VM (reserving one for the host OS), and up to 65% of physical RAM. Custom values are accepted but capped at safe limits to prevent host starvation.
Inputs: name (required), image (required), cpus, append, +5 more.
adb_qemu_statusA
Show status of QEMU virtual machines — running VMs with resource usage and port mappings, plus KVM and QEMU availability.
Inputs: no named parameters.
adb_qemu_stopA
Stop a running QEMU virtual machine. Sends SIGTERM for graceful shutdown, with force kill option.
Inputs: name, force.
adb_rebootB
Reboot the device. Supports normal, recovery, and bootloader modes.
Inputs: mode, device.
adb_registry_installA
Install a plugin from the community registry by name. Downloads the plugin JavaScript file into the plugins directory. Restart DeepADB to load it.
Inputs: name (required), force.
adb_registry_installedA
List all locally installed plugins with their versions and metadata. Shows which plugins have updates available in the registry.
Inputs: no named parameters.
adb_registry_searchA
Search the community plugin registry for available plugins. Shows name, description, version, and author. Fetches the latest manifest from the configured registry URL.
Inputs: query.
adb_regression_baselineA
Capture a performance baseline for a package: memory, CPU, frame stats, battery, and network state. Saves to a timestamped JSON file for later comparison with adb_regression_check.
Inputs: packageName (required), label, device.
adb_regression_checkB
Compare current performance against a saved baseline. Flags regressions in memory (>20% increase), CPU (>50% increase), and jank rate (>25% increase). Thresholds are configurable.
Inputs: baselinePath (required), device, cpuThreshold, jankThreshold, +1 more.
adb_regression_historyB
List all saved regression baselines, optionally filtered by package name. Shows trends over time.
Inputs: packageName.
adb_resolve_intentsB
Discover all activities, services, and receivers registered by a package with their intent filters
Inputs: packageName (required), device.
adb_restart_appB
Force-stop then re-launch an app. The most frequent debugging workflow in a single call.
Inputs: packageName (required), device, delayMs.
adb_result_dropA
Delete a stored result handle, or clear all handles in this session. Either provide both tool and name to drop one specific handle, or pass all: true to drop everything in the current namespace. Useful for freeing up the store cap proactively or removing stale data before a sensitive operation.
Inputs: all, name, tool.
adb_result_getA
Retrieve the content of a stored result handle by tool name + handle name. Returns the original content blocks as the source tool produced them. Updates the handle's last-accessed time. For URI-based retrieval, read result://<tool>/<name> as an MCP Resource instead.
Inputs: name (required), tool (required).
adb_result_listA
List all result handles currently stored in this session. Returns metadata for each: tool, name, size, creation/expiry/last-access times. Use the URIs (result://<tool>/<name>) with adb_result_get or by reading them as MCP Resources to retrieve stored content. Handles are scoped per-auth-token and survive server restart within their TTL.
Inputs: no named parameters.
adb_reverseA
Reverse-forward a device port to a port on the host (device → host). Use for letting device apps reach services on your machine.
Inputs: local (required), remote (required), device.
adb_reverse_removeB
Remove a reverse forward (device → host), or all reverse forwards. Use after testing to clean up.
Inputs: device, remote.
adb_revoke_permissionA
Revoke a runtime permission from a package. Useful for resetting permission state to test first-run flows or denial handling.
Inputs: permission (required), packageName (required), device.
adb_ril_pollB
Retrieve captured RIL messages since the last poll. Optionally filter by category (registration, cell_info, signal, network, security, handover, data, radio_state, nas).
Inputs: session (required), raw, category, maxMessages.
adb_ril_startC
Start capturing RIL (Radio Interface Layer) messages from the radio logcat buffer. Captures network registration, cell info, signal strength, authentication, handover, and NAS events. Useful for radio diagnostics and cellular network research.
Inputs: device, bufferSize, includeKernel.
adb_ril_stopB
Stop a RIL capture session. Shows a summary of captured message categories.
Inputs: session (required).
adb_rmA
Delete a file or directory on the device. Recursive deletion uses depth-based protection: refuses at depth ≤ 2 from root (blocks rm -rf /system or /sdcard but allows /sdcard/project/build/). Symlinks are resolved before depth checks to prevent traversal bypasses. Hard-blocks /dev, /proc, /sys. For recursive deletes, reports a pre-flight file count.
Inputs: path (required), root, device, recursive.
adb_root_shellB
Execute a command as root via su. Requires rooted device.
Inputs: command (required), device.
adb_runtime_auditB
Run a unified, read-only DeepADB readiness audit covering transport, authorization, Android state, root, SELinux, storage, common binaries, UI/network support, SQLite, chipset/modem nodes, and Wear prerequisites. Makes no device changes.
Inputs: device.
adb_screenA
Control screen state: wake, sleep, toggle, lock, or unlock. Lock and unlock verify actual keyguard state via dumpsys window. Unlock uses wm dismiss-keyguard (works for swipe keyguards); supply 'pin' to perform the full PIN entry sequence for PIN-protected devices: wakes screen, dismisses keyguard, swipes up to reveal keypad, types PIN, confirms with ENTER, and verifies the keyguard sleep token was released.
Inputs: action (required), pin, device.
adb_screencapB
Take a screenshot and save to local filesystem. Returns the file path.
Inputs: device, filename.
adb_screencap_annotatedA
Take a screenshot with UI element bounding boxes and numbered labels composited directly onto the image. Returns the annotated PNG path plus a text legend mapping each element number to its identity. Ideal for LLM workflows that need to reference specific UI elements by number rather than by coordinates.
Inputs: device, filename, clickableOnly.
adb_screenrecord_startA
Start recording the device screen. Recording runs on-device. Use adb_screenrecord_stop to finish and pull the video file.
Inputs: device, maxDuration.
adb_screenrecord_stopA
Stop an active screen recording and pull the video file locally. If the recording has already finished (hit time limit), this just pulls the file.
Inputs: device.
adb_screenshot_baselineA
Capture a named screenshot baseline for later comparison. Saves the screenshot and metadata to the baselines directory.
Inputs: name (required), device, result_handle, result_handle_ttl.
adb_screenshot_compressedA
Take a screenshot and pull the full-resolution PNG, plus metadata for client-side compression. Returns local file path, dimensions, file size, and a ready-to-run imagemagick command for converting to a smaller JPEG. (Android doesn't ship imagemagick, so the actual compression is post-processing — this tool sets up everything you need.)
Inputs: scale, device, quality, filename.
adb_screenshot_diffA
Compare the current screen against a saved screenshot baseline. Decodes PNGs and performs pixel-level comparison (RGB channels), reporting exact pixel difference count, percentage, and the bounding box of the changed region. Supports a tolerance threshold for absorbing minor dynamic elements like clocks or notification badges.
Inputs: baseline (required), device, result_handle, tolerancePercent, +1 more.
adb_screenshot_historyB
List all saved screenshot baselines with their metadata (timestamp, dimensions, device, file size).
Inputs: result_handle, result_handle_ttl.
adb_screen_sizeA
Get the screen resolution and display density. Returns physical width, height (in pixels), and DPI density. Useful for calculating tap/swipe coordinates and understanding the UI layout grid.
Inputs: device.
adb_screen_stateA
Get a combined screen state snapshot in one call: foreground activity, screen dimensions and density, orientation, battery level, and a TSV list of interactive UI elements. Replaces 3-4 separate tool calls with a single round-trip. Ideal as a first step in any automation workflow.
Inputs: device, clickableOnly.
adb_scroll_untilB
Scroll the screen repeatedly until a target element is found. Performs a swipe gesture, then checks the UI hierarchy for the target. Repeats until found or max iterations reached. Useful for finding elements in long lists or scrollable content.
Inputs: text, device, direction, maxScrolls, +3 more.
adb_selinux_denialsB
List recent SELinux AVC denial messages from logcat and kernel logs. Shows which processes were blocked, what they tried to do, and the SELinux contexts involved. Useful for diagnosing permission issues and understanding security policy enforcement.
Inputs: lines, device, process.
adb_selinux_statusA
Check SELinux enforcement mode, policy version, and recent denial count. Shows whether the device is in Enforcing, Permissive, or Disabled mode. Root access provides additional policy details from dmesg audit logs.
Inputs: device.
adb_sensor_readA
Read current hardware sensor values from the device. Enumerates all available sensors from sensorservice and returns their last-known readings with timestamps. Sensor availability is device-dependent — the tool reports what's present. No root required.
Inputs: device, category, listOnly.
adb_settings_getB
Read an Android settings value from any namespace (system, secure, global)
Inputs: key (required), namespace (required), device.
adb_settings_putC
Write an Android settings value to any namespace (system, secure, global)
Inputs: key (required), value (required), namespace (required), device.
adb_shannon_sessionA
Preflight a Samsung Shannon/Exynos modem session by checking the chipset, root access, known AT ports, and a benign AT handshake together. Optionally sends ATI for identification after a successful handshake. Makes no modem configuration changes.
Inputs: port, device, timeout, includeIdentity.
adb_shellC
Execute a shell command on the Android device. Returns stdout and stderr.
Inputs: command (required), device, timeout.
adb_signal_detailB
Get detailed signal strength measurements: RSRP, RSRQ, SINR, RSSI, timing advance, and signal bars. Provides raw radio measurements for signal analysis and anomaly detection.
Inputs: device.
adb_snapshot_captureB
Capture a comprehensive device state snapshot: installed packages, key settings, and system properties. Saves to a JSON file.
Inputs: name, device.
adb_snapshot_compareA
Compare current device state against a saved snapshot. Shows added/removed packages, changed settings, and property differences.
Inputs: snapshotPath (required), device.
adb_snapshot_restore_settingsA
Restore settings from a saved snapshot to the current device. Only restores global and secure settings — does not install/uninstall packages.
Inputs: snapshotPath (required), device, namespace.
adb_sqlite_inspectA
Safely inspect a Room or SQLite database inside an installed app. Lists package databases, shows schema, or executes one validated read-only query. Requires a debuggable app (run-as) or root; queries a bounded private snapshot with device sqlite3 or an isolated host SQLite process.
Inputs: packageName (required), query, access, action, +3 more.
adb_start_activityC
Start an activity or app by intent or component name
Inputs: intent (required), device.
adb_start_appA
Launch an app by package name (resolves and starts the default launcher activity)
Inputs: packageName (required), device.
adb_tap_elementA
Find a UI element by text, resource-id, or content-description, then tap its center. Combines UI hierarchy search with input tap in one atomic operation. More reliable than coordinate-based taps for dynamic layouts.
Inputs: text, index, device, resourceId, +1 more.
adb_tcpdump_startA
Start a packet capture on the device using tcpdump. Requires root or tcpdump binary on device. Capture runs in background.
Inputs: device, filter, interface, maxPackets.
adb_tcpdump_stopA
Stop an active packet capture and pull the pcap file locally for analysis.
Inputs: device.
adb_tcpipA
Switch a USB-connected device to TCP/IP mode on the specified port (default 5555). After this, you can disconnect USB and use adb_connect.
Inputs: port, device.
adb_telephonyC
Get telephony state including cell info, signal strength, and network registration.
Inputs: device.
adb_test_gen_from_intentsA
Analyze a package's registered activities and intent filters to generate a test workflow that launches each exported activity and verifies it renders. Produces workflow JSON compatible with adb_workflow_run.
Inputs: packageName (required), device.
adb_test_gen_from_uiA
Analyze the current screen and generate a test workflow that taps each interactive element, takes screenshots, and verifies the app doesn't crash. Produces a workflow JSON compatible with adb_workflow_run.
Inputs: packageName (required), device, returnToStart, screenshotAfterEach.
adb_test_gen_saveB
Save a generated workflow JSON to the workflows directory for later execution with adb_workflow_run.
Inputs: name (required), workflow (required).
adb_test_session_endA
End the active test session. Writes a summary manifest and returns the session directory path.
Inputs: no named parameters.
adb_test_session_startA
Start a structured test session. Creates a named directory for organizing numbered screenshots and logcat captures.
Inputs: name (required), device.
adb_test_stepA
Capture a numbered test step: takes a screenshot and captures logcat since the last step. Saves both to the session directory.
Inputs: description (required), captureLogcat, captureScreenshot.
adb_thermal_compareA
Compare current thermal/power state against a saved baseline. Reports temperature changes per zone, CPU frequency shifts, and battery drain rate differences.
Inputs: device, baselinePath.
adb_thermal_snapshotA
Capture a thermal and power snapshot: all thermal zone temperatures, per-CPU frequencies and governors, cooling device states, and battery temperature/current draw. Optionally save as a baseline for later comparison.
Inputs: save, label, device.
adb_topC
Get current CPU and memory usage snapshot
Inputs: count, device.
adb_tunnel_closeA
Close a managed tunnel by ID, or all managed tunnels at once. The corresponding adb forward/reverse entry is removed and the tunnel is dropped from the cleanup registry. Use adb_tunnel_list to see active tunnel IDs.
Inputs: id (required).
adb_tunnel_listA
List all active managed tunnels (opened via adb_tunnel_open). Shows tunnel ID, device, direction, and both endpoints. Note: this only surfaces tunnels created via adb_tunnel_open — tunnels created via the low-level adb_forward / adb_reverse won't appear here. For those, use adb_forward_list.
Inputs: device.
adb_tunnel_openA
Open a managed tunnel between host and device. Higher-level convenience wrapper over adb_forward / adb_reverse: auto-picks a free host port when one isn't specified (forward only), returns an opaque tunnel ID for later close, and registers cleanup so the tunnel is removed on server exit. Direction 'forward' = host port forwards TO device service; 'reverse' = device port forwards TO host service.
Inputs: direction (required), deviceSpec (required), device, hostSpec.
adb_ui_dumpA
Dump the current UI hierarchy. Parses the view tree into structured element data with coordinates, text, resource IDs, and interaction flags. Use format='tsv' for token-efficient compact output, format='xml' for raw uiautomator XML.
Inputs: device, format, clickableOnly.
adb_ui_findA
Search the UI hierarchy for elements matching text, resource-id, or content-description. Returns matching elements with coordinates for precise adb_input targeting.
Inputs: text, device, resourceId, contentDesc.
adb_uninstallC
Uninstall a package from the device
Inputs: packageName (required), device, keepData.
adb_wait_elementA
Wait for a UI element to appear or disappear. Polls the UI hierarchy at regular intervals until the condition is met or timeout expires. Useful for waiting after navigation, animations, or async content loading.
Inputs: text, device, pollMs, condition, +3 more.
adb_wait_stableA
Wait for the UI to stabilize. Polls the UI hierarchy and waits until consecutive dumps produce the same element count and structure. Useful after screen transitions, animations, or content loading before interacting with elements.
Inputs: device, pollMs, timeoutMs, stableCount.
adb_wear_datalayer_preflightA
Run a read-only Wear OS Data Layer preflight across a connected phone and watch. Checks device roles, Google Play services, Bluetooth, optional app packages, companion association presence, and Data Layer service signals without exposing pairing identifiers.
Inputs: wearDevice, phoneDevice, wearPackage, phonePackage.
adb_wifiC
Enable or disable WiFi
Inputs: enabled (required), device.
adb_wifi_firmwareC
WiFi chipset and firmware identification. Reports WiFi driver version, firmware version, chipset/hardware info, supported bands and standards, interface details, and dumpsys excerpts. BH7 fix: dumpsys truncation now configurable via maxLines. connection state. MAC address is opt-in only (permanent hardware identifier).
Inputs: device, maxLines, includeMac.
adb_workflow_listB
List saved workflow files in the workflows directory.
Inputs: no named parameters.
adb_workflow_runB
Execute a workflow — a JSON-defined sequence of device operations with variable substitution, conditional steps, and loop support. Supported actions: shell, root_shell, install, screenshot, logcat, getprop, sleep. Pass the workflow as a JSON string or provide a saved workflow name.
Inputs: workflow (required), device, dryRun, variables.
adb_workflow_validateA
Validate a workflow JSON definition without executing it. Reports structural errors and shows the execution plan.
Inputs: workflow (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 209 tools
Many tools overlap in purpose: adb_screencap, adb_screencap_annotated, adb_screenshot_compressed, adb_screenshot_baseline, adb_screen_state, adb_device_state, and adb_current_activity all partially overlap on screenshots/state. Likewise adb_input vs. adb_input_tap/swipe/text/drag/fling/long_press/double_tap/pinch/batch_actions, and adb_health_check vs. adb_runtime_audit vs. adb_ci_device_ready create real selection ambiguity. Descriptions help, but an agent can easily pick a plausible-but-suboptimal tool.
Nearly all tools use the adb_ prefix with snake_case and mostly action-oriented names, which is predictable. Minor deviations exist in ordering and abstraction level (adb_file_chmod vs. adb_chmod-style naming, adb_screen vs. adb_screencap, and mixed resource/action ordering), but the convention is still readable.
209 tools is far beyond what is appropriate even for a broad ADB automation platform, and many tools are narrow wrappers or convenience combinations. The surface is large enough to overwhelm tool selection and materially increases the chance of misselection.
Coverage is unusually broad: device management, file operations, UI automation, input, networking, telephony/radio, firmware, QEMU, testing, workflows, and plugins are all represented. There are minor lifecycle gaps such as deletion/cleanup for saved profiles, baselines, or workflows, but core workflows are well covered.
Maintenance
Related MCP Connectors
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
A registry of AI agent tools — MCP servers, APIs, CLIs, SDKs — kept current by automated ingestion.
MCP server for building and testing AI agents with multi-model experimentation and insights.
Related MCP Servers
- AlicenseAqualityCmaintenanceA 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.20MIT
- FlicenseNot gradedqualityDmaintenanceA powerful MCP server that provides comprehensive Android device automation capabilities through ADB, enabling AI agents to interact with Android devices for testing, automation, and device control tasks.1-
- AlicenseNot gradedqualityDmaintenanceAn MCP server that wraps Android ADB functionality into AI assistant tools, enabling device management, shell execution, file operations, app management, media capture, and log analysis via natural language.23 npm3MIT
- FlicenseAqualityDmaintenanceAn MCP server designed for Android development, enabling AI assistants to directly control Android devices for screenshots, UI analysis, app management, and more.19-