ADB MCP-Server

Ein MCP-Server (Model Context Protocol) für die Interaktion mit Android-Geräten über ADB. Dieses TypeScript-basierte Tool schlägt eine Brücke zwischen KI-Modellen und der Funktionalität von Android-Geräten.

Merkmale

• 📱 Geräteverwaltung – Auflisten und Interagieren mit verbundenen Android-Geräten

• 📦 App-Installation – Stellen Sie APK-Dateien auf verbundenen Geräten bereit

• 📋 Protokollierung – Zugriff auf Geräteprotokolle über Logcat

• 🔄 Dateiübertragung – Push- und Pull-Dateien zwischen Gerät und Host

• 📸 UI-Interaktion – Screenshots aufnehmen und UI-Hierarchie analysieren

• 🔧 Shell-Befehlsausführung – Führen Sie benutzerdefinierte Befehle auf dem Gerät aus

Voraussetzungen

• Node.js (v16 oder höher empfohlen, getestet mit Node.js v16, v18 und v20)

• ADB (Android Debug Bridge) installiert und in Ihrem PATH

• Ein über USB oder Netzwerk verbundenes Android-Gerät oder -Emulator mit aktiviertem USB-Debugging

• Berechtigung zum Zugriff auf das Gerät (akzeptierte Debugging-Autorisierung auf dem Gerät)

Installation

Installation über Smithery

So installieren Sie ADB Android Device Server für Claude Desktop automatisch über Smithery :

Manuelle Installation

Konfiguration

ADB-Pfadkonfiguration

Der Server verwendet Standard-ADB-Pfade. Für benutzerdefinierten ADB-Speicherort:

MCP-Konfiguration

Fügen Sie die ADB MCP-Serverkonfiguration hinzu:

Verwendung

Starten des Servers

WICHTIG: Der Server muss ausgeführt werden, bevor ADB-Tools verwendet werden.

Starten Sie den Server mit:

Folgendes sollte angezeigt werden:

Lassen Sie dieses Terminalfenster geöffnet, während Sie die ADB-Tools verwenden.

Verfügbare Tools

Alle Tools sind mit der folgenden Namenskonvention verfügbar:

📱 Geräteverwaltung

• adb_devices - Liste verbundener Geräte

• adb_shell - Shell-Befehle auf einem Gerät ausführen

📦 App-Verwaltung

• adb_install - Installieren Sie eine APK-Datei unter Verwendung eines lokalen Dateipfads

📋 Protokollierung

• adb_logcat - Geräteprotokolle mit optionaler Filterung anzeigen

🔄 Dateiübertragung

• adb_pull - Dateien von einem Gerät abrufen

• adb_push - Dateien auf ein Gerät übertragen

🔍 UI-Interaktion

• dump_image - Machen Sie einen Screenshot des aktuellen Bildschirms

• inspect_ui – UI-Hierarchie im XML-Format abrufen (am nützlichsten für die KI-Interaktion)

Fehlerbehebung

Wenn Tools nicht funktionieren:

• Serverprobleme:

  • Stellen Sie sicher, dass der Server läuft ( npx adb-mcp )

  • Überprüfen Sie die Serverausgabe auf Fehlermeldungen

  • Versuchen Sie detaillierte Protokolle: LOG_LEVEL=3 npx adb-mcp

  • Hängende Prozesse beenden:

    • ps aux | grep "adb-mcp" | grep -v grep

    • dann kill -9 [PID]

• Geräteanschluss:

  • Überprüfen Sie die Verbindung mit adb_devices

  • Wenn „nicht autorisiert“, akzeptieren Sie die Debug-Autorisierung auf dem Gerät

  • Überprüfen Sie die USB-/Netzwerkverbindungen

  • Versuchen Sie, ADB neu zu starten: adb kill-server && adb start-server

• ADB-Probleme:

  • Überprüfen Sie die ADB-Installation: adb version

• Geräteeinrichtung:

  • Verwenden Sie einen Emulator (es wurde mit einem solchen erstellt). Versuchen Sie für echte Geräte vielleicht Folgendes:

    • Stellen Sie sicher, dass USB-Debugging aktiviert ist

    • Aktivieren Sie bei neueren Android-Versionen „USB-Debugging (Sicherheitseinstellungen)“

    • Probieren Sie einen anderen USB-Anschluss oder ein anderes Kabel aus

    • oder lassen Sie es mich in einer Ausgabe wissen

Kompatibilität

• Android 8.0 und höher

• MCP-Clients, einschließlich Claude in Cursor IDE

• Wurde auf macOS erstellt, sollte aber auf jedem POSIX-kompatiblen System (Linux usw.) laufen.

• Habe es nicht unter Windows versucht, aber vielleicht funktioniert es.

Beitragen

• Beiträge sind willkommen! Senden Sie einen Pull Request.

• Öffnen Sie bei größeren Änderungen zunächst ein Problem zur Diskussion.

• Sie können es natürlich auch forken

• Hinweis: Dieses Projekt wurde vibe-coded erstellt. Wenn Sie also seltsame Dinge entdecken, wissen Sie Bescheid. 🙂

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE .

Danksagung

• Erstellt mit Model Context Protocol (MCP)