Mobile Next - iOS, Android, Simulator, Emulator ve Gerçek Cihazlar için MCP sunucusu | Mobil Geliştirme ve Otomasyon

Bu bir Model Context Protocol (MCP) sunucusudur ve ölçeklenebilir mobil otomasyon, platform-agnostik bir arayüz aracılığıyla geliştirme sağlar, iOS veya Android bilgisi gerektirme ihtiyacını ortadan kaldırır. Bunu emülatörlerde, simulatörlerde ve gerçek cihazlarda (iOS ve Android) çalıştırabilirsiniz. Bu sunucu, Agentlerin ve LLM'lerin native iOS/Android uygulamaları ve cihazları erişilebilirlik snapshot'ları veya ekran görüntülerine dayalı koordinat tabanlı dokunuşlar aracılığıyla yapılandırılmış bir şekilde kullanmasını sağlar.

https://github.com/user-attachments/assets/bb084777-beb3-4930-ae6f-8d3fe694ddde

</a>

👉 Yol Haritasını Keşfedin

Ana Kullanım Durumları

Mobil otomasyon ölçeklendirmesine nasıl yardımcı oluyoruz:

• 📲 Native uygulama otomasyonu (iOS ve Android) test etme veya veri giriş senaryoları için.
• 📝 Simulatörleri/emülatörleri veya gerçek cihazları (iPhone, Samsung, Google Pixel vb.) manuel olarak kontrol etmeden script akışları ve form etkileşimleri.
• 🧭 LLM tarafından yönetilen çok adımlı kullanıcı yolculuklarını otomatikleştirme.
• 👆 Agent tabanlı frameworkler için genel amaçlı mobil uygulama etkileşimi.
• 🤖 Mobil otomasyon kullanım durumları ve veri çıkarma için agent-to-agent iletişimi sağlama.

Ana Özellikler

• 🚀 Hızlı ve hafif: Çoğu etkileşim için native erişilebilirlik ağaçlarını veya a11y etiketleri olmadığında ekran görüntüsü tabanlı koordinatları kullanır.
• 🤖 LLM dostu: Erişilebilirlik (Snapshot) modunda bilgisayar görüşü modeli gerekli değildir.
• 🧿 Görsel Algı: Ekranda gerçekten ne oluşturulduğunu değerlendirip analiz eder ve sonraki eylemi belirler. Erişilebilirlik verisi veya view-hierarchy koordinatları kullanılamıyorsa, ekran görüntüsü tabanlı analize geri döner.
• 📊 Belirleyici tool uygulaması: Mümkün olduğunda yapılandırılmış verilere güvenerek tamamen ekran görüntüsü tabanlı yaklaşımlarda bulunan belirsizliği azaltır.
• 📺 Yapılandırılmış verileri çıkarma: Ekranda görünen herhangi bir şeyden yapılandırılmış verileri çıkarmanızı sağlar.

🎯 Platform Desteği

🔧 Mevcut MCP Araçları

🏗️ Mobile MCP Mimarisi

</a>

Setup, konfigürasyon ve hata ayıklama ile ilgili sorular için wiki sayfamızda daha fazla detay bulabilirsiniz.

Kurulum ve Konfigürasyon

Standart konfigürasyon çoğu araçta çalışır:

{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": ["-y", "@mobilenext/mobile-mcp@latest"]
    }
  }
}

"amp.mcpServers": {
  "mobile-mcp": {
    "command": "npx",
    "args": [
      "@mobilenext/mobile-mcp@latest"
    ]
  }
}

amp mcp add mobile-mcp -- npx @mobilenext/mobile-mcp@latest

claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp@latest

codex mcp add mobile-mcp npx "@mobilenext/mobile-mcp@latest"

[mcp_servers.mobile-mcp]
command = "npx"
args = ["@mobilenext/mobile-mcp@latest"]

/mcp add

{
  "mcpServers": {
    "mobile-mcp": {
      "type": "local",
      "command": "npx",
      "tools": [
        "*"
      ],
      "args": [
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

gemini mcp add mobile-mcp npx -y @mobilenext/mobile-mcp@latest

{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": [
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mobile-mcp": {
      "type": "local",
      "command": [
        "npx",
        "@mobilenext/mobile-mcp@latest"
      ],
      "enabled": true
    }
  }
}

npx @mobilenext/mobile-mcp@latest

Wiki'de daha fazla bilgi! 🚀

SSE Sunucu Modu

Varsayılan olarak, Mobile MCP stdio üzerinde çalışır. Bunun yerine bir SSE sunucusu başlatmak için --listen bayrağını kullanın:

npx @mobilenext/mobile-mcp@latest --listen 3000

Bu localhost:3000'a bağlanır. Belirli bir arayüze bağlanmak için:

npx @mobilenext/mobile-mcp@latest --listen 0.0.0.0:3000

Ardından MCP istemcinizi http://<host>:3000/mcp'ye bağlanacak şekilde yapılandırın.

Yetkilendirme

SSE sunucusunda Bearer token yetkilendirmesi gerekli kılmak için MOBILEMCP_AUTH ortam değişkenini ayarlayın:

MOBILEMCP_AUTH=my-secret-token npx @mobilenext/mobile-mcp@latest --listen 3000

Ayarlandığında, tüm istekler Authorization: Bearer my-secret-token başlığını içermelidir.

🛠️ Nasıl Kullanılır 📝

MCP sunucusunu IDE/Client'inize ekledikten sonra, AI asistanınıza mevcut araçları kullanması için talimat verebilirsiniz. Örneğin, Cursor'ın agent modunda, aşağıdaki promptları kullanarak hızlı bir şekilde UI etkileşimlerini doğrulayabilir, test edebilir ve tekrarlayabilirsiniz, ekrandan bilgi okuyabilir, karmaşık iş akışlarını gerçekleştirebilirsiniz. Açıklayıcı ve net olun.

✨ Örnek Promptlar

İş Akışları

Tek bir promptta ayrıntılı iş akışları belirtebilir, iş mantığını doğrulayabilir, otomasyon kurabilirsiniz. Çılgınca gidebilirsiniz:

Bir video arayın, yorum yazın, beğenin ve paylaşın.

"Beginner Recipe for Tonkotsu Ramen" adlı videoyu Way of Ramen tarafından bulun, videoyu beğen düğmesine tıklayın, beğendikten sonra "bu lezizdi, gelecek Cuma yapacağım" yazarak bir yorum yazın, videoyu WhatsApp listenizde ilk iletişim kişisine paylaşın.

Başarılı bir adım sayacı uygulaması indirin, kaydolun, antrenmanı kurun ve uygulamayı 5 yıldız yapın

1000'den fazla yıldız puanı olan ücretsiz bir "Pomodoro" uygulaması bulun ve indirin. Uygulamayı başlatın, e-postamla kaydolun, kayıt sonrası pomodoro zamanlayıcısı nasıl başlatılacağını bulun. Pomodoro zamanlayıcısı başlatıldığında, app store'a geri gidin ve uygulamayı 5 yıldız verin ve uygulamanın ne kadar faydalı olduğunu anlatan bir yorum bırakın.

Substack'te arayın, oku, vurgula, yorum yaz ve bir makale kaydet

Substack web sitesini açın, "Latest trends in AI automation 2025" araması yapın, ilk makaleyi açın, "Emerging AI trends" başlığı altındaki bölümü vurgulayın ve makaleyi daha sonra gözden geçirilmek üzere okuma listesine kaydedin, rastgele bir paragraf özetini yorum olarak bırakın.

Bir antrenman sınıfı rezerv edin, zamanlayıcı kurun

ClassPass'ı açın, yarın sabah 2 mil içindeki yoga derslerini arayın, en yüksek puanlı sınıfı 7 AM'de rezerv edin, rezervasyonu onaylayın, telefondaki booked slotu için bir zamanlayıcı kurun

Yerel bir etkinlik bulun, takvim etkinliği kurun

Eventbrite'ı açın, bu hafta sonu "Austin, TX"'de gerçekleşecek yapay zeka startup toplantısı etkinlikleri arayın, en popüler olanı seçin, kaydolun ve etkinliğe evet ile RSVP verin, bir takvim etkinliğini hatırlatma olarak kurun.

Hava durumu tahmini kontrol edin ve WhatsApp/Telegram/Slack mesajı gönderin

Hava uygulamasını açın, "Berlin" için yarın hava durumu tahminini kontrol edin ve özeti WhatsApp/Telegram/Slack aracılığıyla "Lauren Trown" iletişim kişisine gönderin, yanıtlarına başparmak yukarı verin.

• Zoom'da bir toplantı planlayın ve davetiyeyi e-posta ile paylaşın

Zoom uygulamasını açın, yarın 10 AM'de "AI Hackathon" başlıklı bir toplantı planlayın, 1 saat süreli, davet bağlantısını kopyalayın ve Gmail üzerinden "team@example.com" kişilerine gönderin.

Daha fazla prompt örneği burada bulunabilir.

Ön Koşullar

MCP'yi agent'iniz ve mobil cihazlarınızla bağlamak için ihtiyaç duyacağınız şeyler:

• Xcode command line tools
• Android Platform Tools
• node.js v22+
• MCP destekli foundation modelleri veya agentler, örneğin Claude MCP, OpenAI Agent SDK, Copilot Studio

Simulatörler, Emülatörler ve Gerçek Cihazlar

Başlatıldığında, Mobile MCP şunlara bağlanabilir:

• macOS/Linux'taki iOS Simulatörleri
• Linux/Windows/macOS'taki Android Emülatörleri
• iOS veya Android gerçek cihazları (uygun platform araçları ve sürücüleri gerekir)

Mobile Next Mobile MCP'yi çalıştırmadan önce mobil platform SDK'larınızın (Xcode, Android SDK) kurulu ve doğru şekilde yapılandırılmış olduğundan emin olun.

Telemetri

Mobile MCP, PostHog aracılığıyla anonim kullanım telemetrisi toplar. Bunu devre dışı bırakmak için MOBILEMCP_DISABLE_TELEMETRY ortam değişkenini ayarlayın:

MOBILEMCP_DISABLE_TELEMETRY=1 npx @mobilenext/mobile-mcp@latest

Json konfigürasyonları için:

{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": ["-y", "@mobilenext/mobile-mcp@latest"],
      "env": {
        "MOBILEMCP_DISABLE_TELEMETRY": "1"
      }
    }
  }
}

Simulatörler/Emülatörlerde "headless" modda çalıştırma

Makinenize bağlı gerçek bir cihaz olmadığında, Mobile MCP'yi arka planda bir emülatör veya simulatör ile çalıştırabilirsiniz.

Örneğin, Android'de:

1. Bir emülatör başlatın (avdmanager / emulator komutu).
2. Mobile MCP'yi istenen bayraklarla çalıştırın

iOS'ta, Mobile MCP'yi o simulatör örneğiyle kullanmadan önce Xcode'u ve Simulator'ü çalıştırmanız gerekecek.

• xcrun simctl list
• xcrun simctl boot "iPhone 16"

Tüm Katkıda Bulunanları Teşekkür Ederiz ❤️

Bu projeyi geliştirmeye yardımcı olan herkesi takdir ediyoruz.