Mobile MCP

لماذا تستخدمه

الميزات الأساسية

متعدد المنصات: نفس الأدوات لـ iOS + Android
يعمل مع المحاكيات والأجهزة الحقيقية
لقطة شاشة + تدرج عرض مكافئ لـ DOM
تثبيت APK/IPA من URL أو مسار محلي
لا حاجة لخبرة في اختبار الهاتف المحمول

عرض مباشر

كيف يبدو في الممارسة

mobile-mcp.replay ▶ جاهز

0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

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

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json

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

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit

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

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json

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

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json

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

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

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

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: Mobile MCP

اختبار دخاني لتطبيقك على iOS + Android من prompt واحد

👤 جودة التطبيقات المتنقلة، المطورون بلا فريق QA متخصص ⏱ ~20 min intermediate

متى تستخدمه: أنجزت للتو بناءً وتريد معرفة ما إذا كان تدفق التسجيل لا يزال يعمل على كلتا المنصتين.

المتطلبات الأساسية

المحاكي مُشغَّل — xcrun simctl boot "iPhone 16" وemulator -avd Pixel_7
التطبيق مثبَّت — اسحب IPA/APK إلى المحاكي أو استخدم أداة install_app

الخطوات

بدء الجلسة

استخدم mobile-mcp. أدرج جميع الأجهزة المتاحة.✓ تم النسخ

→ محاكي iOS + محاكي Android في القائمة
تشغيل التدفق

على كلا الجهازين بالتوازي: افتح تطبيقي، انقر "Sign Up"، أدخل [email protected] / password123، انقر Continue. التقط لقطة لكل خطوة.✓ تم النسخ

→ تسلسل لقطات شاشة لجهازين
التحقق

على كل جهاز، هل شاشة "Verify your email" مرئية؟ إن لا، أبلغ عما تراه.✓ تم النسخ

→ نجاح/فشل لكل منصة مع أدلة

النتيجة: تقرير نجاح/فشل مع لقطات شاشة لكلتا المنصتين في دقيقتين.

المزالق

حساب الاختبار يُقفَل بسبب مكافحة البريد المزعج — استخدم رسائل بريد مؤقتة لكل بناء؛ دوّر حسابات الاختبار

اجمعها مع: filesystem

توليد لقطات شاشة App Store عبر 5 أحجام أجهزة

👤 المطورون المستقلون الذين يرفعون إلى App Store ⏱ ~25 min intermediate

متى تستخدمه: تحتاج لقطات شاشة 6.5" و6.7" و5.5" ولا تريد القيام بذلك يدويًا.

المتطلبات الأساسية

محاكيات لكل حجم مطلوب — أنشئها عبر xcrun simctl بأنواع أجهزة مناسبة

الخطوات

بناء المصفوفة

شغّل محاكيات iPhone 15 Pro Max وiPhone 15 وiPhone SE. ثبّت تطبيقي على كل منها.✓ تم النسخ

→ الثلاثة أجهزة جاهزة مع التطبيق مثبَّتًا
التقاط التدفق

على كل جهاز، انتقل إلى الشاشات الخمس الرئيسية (الإعداد، الخلاصة، التفاصيل، الإعدادات، الترقية). التقط لقطة لكل شاشة بالدقة الكاملة.✓ تم النسخ

→ لقطات شاشة محفوظة لكل جهاز باصطلاح تسمية

النتيجة: لقطات شاشة جاهزة لـ App Store بجميع الأحجام المطلوبة، في تشغيل واحد.

المزالق

لقطات الشاشة تتضمن شريط حالة المحاكي — استخدم --status-bar-style=overridden أو عالج بعد الالتقاط بـ crop

اجمعها مع: filesystem

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

mobile-mcp + filesystem

حفظ لقطات الشاشة في مجلدات QA مُعيَّنة إصدارًا

احفظ كل لقطة شاشة تحت /qa/$(date)/ باسم الاختبار.✓ تم النسخ

mobile-mcp + xcodebuild

البناء والتثبيت والاختبار في تدفق واحد

ابنِ تطبيق iOS عبر xcodebuild، ثبّته عبر mobile-mcp، شغّل الاختبار الدخاني.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداة	المدخلات	متى تستدعيها	التكلفة
list_devices	none	دائمًا أولًا — اعرف ما هو متاح	free
launch_app	device_id, bundle_id	افتح تطبيقك على الجهاز	free
tap	device_id, selector\|coords	تفاعل مع زر أو عنصر تحكم	free
type_text	device_id, text: str	ملء حقل نص (يجب أن يكون في التركيز أولًا)	free
get_view_hierarchy	device_id	اكتشف ما هو معروض على الشاشة	free
screenshot	device_id, path?: str	التحقق البصري	free

التكلفة والحدود

تكلفة التشغيل

حصة API: محلي
الرموز لكل استدعاء: تدرج العرض قد يبلغ 10k+ رمز؛ لقطات الشاشة base64
التكلفة المالية: مجاني
نصيحة: فضّل النقر القائم على selector على تفريغ تدرج العرض الكامل لتوفير الرموز

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: device access (physical USB requires trust dialog)

تخزين بيانات الاعتماد: لا شيء

نقل البيانات الخارجي: لا شيء من MCP؛ لقطات الشاشة تتدفق إلى مزود LLM إن شُورِكت

لا تمنح أبدًا: production device access with PII

لا تختبر على أجهزة ببيانات إنتاج — استخدم حسابات QA مخصصة

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

لا أجهزة في القائمة

شغّل محاكيًا أولًا: xcrun simctl boot / emulator -avd X

تحقق: `xcrun simctl list | grep Booted`

tap_at_coords لا يُصيب الهدف

شغّل get_view_hierarchy واستخدم النقر القائم على selector — الإحداثيات تتكسر عبر أحجام الشاشات المختلفة

الجهاز الحقيقي غير موثوق

على iOS: الإعدادات ← عام ← إدارة الجهاز ← ثق. على Android: فعّل تصحيح USB.

البدائل

Mobile MCP مقابل البدائل

البديل	متى تستخدمها	المقايضة
XcodeBuildMCP	تحتاج بناء + اختبار iOS فقط، لا أتمتة واجهة متعددة المنصات	لا Android؛ أثقل على أدوات البناء
Appium	تريد إطار اختبار متنقل كامل على مستوى CI	إعداد أكثر بكثير؛ ليس MCP أصيلًا

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

التثبيت

اختر العميل

حالات الاستخدام

استخدامات عملية: Mobile MCP

اختبار دخاني لتطبيقك على iOS + Android من prompt واحد

المتطلبات الأساسية

الخطوات

المزالق

توليد لقطات شاشة App Store عبر 5 أحجام أجهزة

المتطلبات الأساسية

الخطوات

المزالق

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

الأدوات

ما يوفره هذا الـ MCP

التكلفة والحدود

تكلفة التشغيل

الأمان

الصلاحيات والأسرار ونطاق الأثر

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

البدائل

Mobile MCP مقابل البدائل

المزيد

الموارد