DroidMind, AI asistanları ile Android cihazları arasında güçlü bir köprü olup, doğal dil aracılığıyla kontrol, debugging ve sistem analizi sağlar. Model Context Protocol (MCP) uygulanarak, DroidMind, AI modellerinin ADB üzerinden Android cihazlarıyla güvenli ve yapılandırılmış bir şekilde doğrudan etkileşim kurmasını sağlar. Agentic coding workflow'unun bir parçası olarak kullanıldığında, DroidMind asistanınızın cihazınızla doğrudan döngüde olmak üzere oluşturmak ve debug etmesini sağlar.

💫 Temel Özellikler

DroidMind, AI asistanlarını şu özelliklere sahip kılar:

• 📱 Cihazları Yönet: USB/TCP-IP üzerinden bağlan, cihazları listele, özellikleri görüntüle ve yeniden başlat.
• 📊 Sistemleri Analiz Et: Loglar'a erişim (logcat, ANR, crash, pil), bug raporlarını yakala ve heap'i döküt.
• 📂 Dosyaları İşle: Cihaz dosyalarını ve dizinlerini gözat, oku, yaz, gönder, çek, sil ve yönet.
• 📦 Uygulamaları Kontrol Et: Uygulamaları kur, kaldır, başlat, durdur, verileri temizle ve uygulama detaylarını (manifest, izinler, aktiviteler) incele.
• 🖼️ UI'yı Otomatikleştir: Dokunuş, kaydırma, metin girdisi ve tuş basışı gerçekleştir.
• 🐚 Shell Komutlarını Çalıştır: Güvenlik bilincine sahip bir framework ile ADB shell komutlarını çalıştır.
• 🔒 Güvenli İşlem Yap: Komut doğrulaması, risk değerlendirmesi ve sanitizasyondan yararlan.
• 💬 Sorunsuz İntegrasyon: Herhangi bir MCP uyumlu istemci (Claude, Cursor, Cline, vb.) ile bağlan.

Yeteneklerin detaylı listesi için Kullanıcı Kılavuzu ve MCP Referansı bölümüne bakın.

🚀 Başlarken

IDE'ler için Hızlı Başlangıç (uvx ile Sıfır Kurulum)

DroidMind'ı bir MCP uyumlu IDE (Cursor gibi) ile entegre etmenin en hızlı yolu, uvx kullanarak doğrudan GitHub repository'sinden çalıştırmak için yapılandırmaktır. Bu yöntem DroidMind'ı manuel olarak klonlamak veya kurmak gerekmez.

IDE'nizin MCP yapılandırmasına aşağıdakini ekleyin (örneğin Cursor için .cursor/mcp.json):

{
  "mcpServers": {
    "droidmind": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/hyperb1iss/droidmind",
        "droidmind",
        "--transport",
        "stdio" // Çoğu IDE entegrasyonu için varsayılan ve tercih edilen mod
      ]
    }
  }
}

IDE'niz isteğe bağlı olarak DroidMind'ı başlatmak için yapılandırılır. Bu kurulumun tam talimatları Hızlı Başlangıç Kılavuzu içinde yer almaktadır.

Gereksinimler

• Python 3.13 (3.14 henüz desteklenmiyor)
• uv (Python paket yöneticisi)
• USB debugging etkinleştirilmiş Android cihazı
• ADB (Android Debug Bridge) yüklü ve sistem PATH'inde

Kurulum

uvx ile hızlı IDE entegrasyonu (Hızlı Başlangıç'ta ele alınan), kaynaktan manuel kurulum veya Docker kullanımı da dahil olmak üzere DroidMind'ı ayarlama hakkında detaylı talimatlar için lütfen Kurulum Kılavuzu bölümüne bakın.

DroidMind'ı Çalıştırma

DroidMind'ı nasıl çalıştıracağınız, kurulumunuza bağlıdır:

• IDE Entegrasyonu (uvx üzerinden): IDE'niz, MCP ayarlarında (örneğin mcp.json) yapılandırıldığı şekilde DroidMind'ı otomatik olarak yönetir. Hızlı Başlangıç Kılavuzu bölümüne bakın.
• Manuel Kurulum: Kaynaktan yükledikten sonra, DroidMind'ı doğrudan çalıştırabilirsiniz.
  • Stdio (doğrudan terminal etkileşimi veya bazı IDE kurulumları için):

    droidmind --transport stdio
    

  • SSE (web UI'ları veya Claude Desktop gibi AI asistanları için):

    droidmind --transport sse
    

    Bu genellikle sse://localhost:4256/sse adresinde bir sunucu başlatır.
• Docker: DroidMind'ı bir container'da çalıştırmak için komutlar Docker Kılavuzu bölümüne bakın.

DroidMind'ı farklı ortamlarda çalıştırma hakkında daha fazla detay için Kurulum Kılavuzu bölümüne bakın.

🐳 Docker ile Çalıştırma

DroidMind, tutarlı, konteynerleştirilmiş bir ortam için Docker kullanılarak da çalıştırılabilir. Bu, dağıtım ve bağımlılıkları izole etmek için özellikle yararlıdır.

Docker imajını oluşturma ve DroidMind'ı stdio veya SSE transport ile bir container'da çalıştırma hakkında kapsamlı talimatlar ve ADB cihaz erişimi hakkında notlar için, lütfen Docker Kılavuzu bölümüne bakın.

🔮 Örnek AI Asistanı Sorguları

DroidMind'a bağlı bir AI asistanı ile aşağıdakine benzer istekler yapabilirsiniz:

• "Bağlı tüm Android cihazlarını listele ve özelliklerini göster."
• "Pixel'imin bir ekran görüntüsünü al."
• "emulator-5554 üzerine bu APK'yı kur."
• "your_device_serial adlı cihazdan son crash loglarını göster."
• "emulator-5554 cihazının mevcut ekranındaki 'Sonraki' düğmesine dokunun."

Daha fazla fikir için, Kullanıcı Kılavuzu'nda Örnek Sorgular ve Workflow'lar bölümüne bakın.

🔒 Güvenlik

DroidMind, cihazlarınızı korumak için bir güvenlik framework'ü içerir:

• Komut Doğrulaması ve Sanitizasyonu
• Risk Değerlendirmesi Kategorilendirmesi
• Korumalı Yol İşlemleri
• Kapsamlı Logging

Yüksek riskli işlemler işaretlenir ve kritik olanlar varsayılan olarak engellenir. Daha fazlasını Güvenlik Hususları bölümünde öğrenin.

💻 Geliştirme

DroidMind, bağımlılık yönetimi ve geliştirme workflow'ları için uv kullanır.

# Bağımlılıkları yükle/güncelle (.venv oluşturur/günceller)
uv sync --all-groups

# Testleri çalıştır
uv run pytest

# Linting'i çalıştır
uv run ruff check .

# Tür kontrolünü çalıştır
uv run pyright

🤝 Katkıda Bulunma

Katkılar memnuniyetle karşılanır! Lütfen bir Pull Request göndermekten çekinmeyin.

1. Repository'yi fork edin.
2. Özellik dalınızı oluşturun (git checkout -b feature/amazing-feature).
3. Geliştirme ortamınızı uv ile ayarlayın.
4. Değişikliklerinizi yapın.
5. Testleri, linting'i ve tür kontrolünü çalıştırın.
6. Değişikliklerinizi işleyin (git commit -m 'Add some amazing feature').
7. Dalına push edin (git push origin feature/amazing-feature).
8. Bir Pull Request açın.

📝 Lisans

Bu proje Apache Lisansı altında lisanslanmıştır - detaylar için LICENSE dosyasına bakın.

---