ADB MCP Server

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)