DroidMind

🤖 DroidMind 🧠

Steuern Sie Android-Geräte mit KI über das Model Context Protocol

DroidMind ist eine leistungsstarke Brücke zwischen KI-Assistenten und Android-Geräten und ermöglicht Steuerung, Debugging und Systemanalyse mithilfe natürlicher Sprache. Durch die Implementierung des Model Context Protocol (MCP) ermöglicht DroidMind KI-Modellen die sichere und strukturierte direkte Interaktion mit Android-Geräten über ADB. Im Rahmen eines agentenbasierten Coding-Workflows ermöglicht DroidMind Ihrem Assistenten das direkte Erstellen und Debuggen mit Ihrem Gerät.

💫 Kernfunktionen

DroidMind ermöglicht KI-Assistenten Folgendes:

• 📱 Geräte verwalten : Über USB/TCP-IP verbinden, Geräte auflisten, Eigenschaften anzeigen und neu starten.
• 📊 Systeme analysieren : Auf Protokolle zugreifen (Logcat, ANR, Absturz, Batterie), Fehlerberichte erfassen und Heap sichern.
• 📂 Dateien verwalten : Gerätedateien/-verzeichnisse durchsuchen, lesen, schreiben, pushen, pullen, löschen und verwalten.
• 📦 Apps steuern : Installieren, deinstallieren, starten, stoppen, Daten löschen und App-Details überprüfen (Manifest, Berechtigungen, Aktivitäten).
• 🖼️ Benutzeroberfläche automatisieren : Tippen, Wischen, Texteingabe und Tastendrücken durchführen.
• 🐚 Shell-Befehle ausführen : Führen Sie ADB-Shell-Befehle mit einem sicherheitsbewussten Framework aus.
• 🔒 Sicherer Betrieb : Profitieren Sie von Befehlsvalidierung, Risikobewertung und Bereinigung.
• 💬 Nahtlose Integration : Verbindung mit jedem MCP-kompatiblen Client (Claude, Cursor, Cline usw.).

Eine detaillierte Liste der Funktionen finden Sie im Benutzerhandbuch und in der MCP-Referenz .

🚀 Erste Schritte

Schnellstart für IDEs (Zero Install mit uvx )

Um DroidMind am schnellsten in eine MCP-kompatible IDE (wie Cursor) zu integrieren, können Sie diese so konfigurieren, dass DroidMind mithilfe von uvx direkt aus dem GitHub-Repository ausgeführt wird. Bei dieser Methode ist kein manuelles Klonen oder Installieren von DroidMind erforderlich .

Fügen Sie der MCP-Konfiguration Ihrer IDE Folgendes hinzu (z. B. .cursor/mcp.json für Cursor):

Ihre IDE wird so konfiguriert, dass DroidMind bei Bedarf gestartet wird. Eine vollständige Anleitung zur Einrichtung finden Sie in der Kurzanleitung .

Voraussetzungen

• Python 3.13 oder höher
• uv (Python-Paketmanager)
• Android-Gerät mit aktiviertem USB-Debugging
• ADB (Android Debug Bridge) installiert und im PATH Ihres Systems

Installation

Ausführliche Anweisungen zum Einrichten von DroidMind, einschließlich der schnellen IDE-Integration mit uvx (behandelt im Schnellstart), der manuellen Installation aus der Quelle oder der Verwendung von Docker, finden Sie in unserem umfassenden Installationshandbuch .

DroidMind ausführen

Wie Sie DroidMind ausführen, hängt von Ihrem Setup ab:

• IDE-Integration (über uvx ) : Ihre IDE verwaltet die Ausführung von DroidMind automatisch gemäß den MCP-Einstellungen (z. B. mcp.json ). Weitere Informationen finden Sie in der Kurzanleitung .
• Manuelle Installation : Nach der Installation aus der Quelle können Sie DroidMind direkt ausführen.
  • Stdio (für direkte Terminalinteraktion oder einige IDE-Setups):
    droidmind --transport stdio
  • SSE (für Web-Benutzeroberflächen oder KI-Assistenten wie Claude Desktop):
    droidmind --transport sse
    Dadurch wird normalerweise ein Server unter sse://localhost:4256/sse gestartet.
• Docker : Befehle zum Ausführen von DroidMind in einem Container finden Sie im Docker-Handbuch .

Weitere Einzelheiten zum Ausführen von DroidMind in verschiedenen Umgebungen finden Sie im Installationshandbuch .

🐳 Ausführen mit Docker

DroidMind kann auch mit Docker ausgeführt werden, um eine konsistente, containerisierte Umgebung zu schaffen. Dies ist besonders nützlich für die Bereitstellung und Isolierung von Abhängigkeiten.

Umfassende Anweisungen zum Erstellen des Docker-Images und zum Ausführen von DroidMind in einem Container mit stdio oder SSE Transport, einschließlich Hinweisen zum ADB-Gerätezugriff, finden Sie in unserem Docker-Handbuch .

🔮 Beispiele für KI-Assistentenabfragen

Mit einem mit DroidMind verbundenen KI-Assistenten können Sie Anfragen stellen wie:

• "Listet alle verbundenen Android-Geräte auf und zeigt ihre Eigenschaften an."
• „Mach einen Screenshot von meinem Pixel.“
• „Installieren Sie dieses APK auf emulator-5554 .“
• „Zeigen Sie mir die letzten Absturzprotokolle von your_device_serial .“
• „Tippen Sie auf dem aktuellen Bildschirm des emulator-5554 auf die Schaltfläche ‚Weiter‘.“

Weitere Inspiration finden Sie in unseren Beispielabfragen und -workflows im Benutzerhandbuch.

🔒 Sicherheit

DroidMind enthält ein Sicherheitsframework zum Schutz Ihrer Geräte:

• Befehlsvalidierung und -bereinigung
• Kategorisierung der Risikobewertung
• Geschützte Pfadvorgänge
• Umfassende Protokollierung

Hochriskante Vorgänge werden gekennzeichnet und kritische Vorgänge standardmäßig blockiert. Weitere Informationen finden Sie im Kapitel „Sicherheitshinweise“ .

💻 Entwicklung

DroidMind verwendet uv für Abhängigkeitsmanagement und Entwicklungs-Workflows.

🤝 Beitragen

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

1. Forken Sie das Repository.
2. Erstellen Sie Ihren Feature-Zweig ( git checkout -b feature/amazing-feature ).
3. Richten Sie Ihre Entwicklungsumgebung mit uv ein.
4. Nehmen Sie Ihre Änderungen vor.
5. Führen Sie Tests, Lint-Tests und Typprüfungen durch.
6. Übernehmen Sie Ihre Änderungen ( git commit -m 'Add some amazing feature' ).
7. Pushen Sie zum Zweig ( git push origin feature/amazing-feature ).
8. Öffnen Sie eine Pull-Anfrage.

📝 Lizenz

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

Erstellt von Stefanie Jane 🌠

Wenn Sie DroidMind nützlich finden, kaufen Sie mir ein Monster Ultra Violet ⚡️