عن المشروع

Mobile MCP هو خادم Model Context Protocol (MCP) لتطوير وأتمتة الجوال. يوفّر واجهة مستقلة عن المنصة حتى يتمكن الوكلاء والنماذج اللغوية الكبيرة من التفاعل مع تطبيقات iOS وAndroid الأصلية دون الحاجة إلى خبرة منفصلة في iOS أو Android. يعمل مع العملاء المتوافقين مع MCP مثل Claude Code وCodex وGemini وGitHub Copilot وAntigravity، ويمكنه استهداف الأجهزة على الجهاز المحلي أو الأجهزة البعيدة عبر خدمة سحابية مستضافة. تشمل الأهداف المدعومة محاكيات iOS (عبر Xcode وxcrun simctl)، وأجهزة iOS الحقيقية المتصلة عبر USB، ومحاكيات Android (عبر adb)، وأجهزة Android الحقيقية مع تمكين تصحيح USB. يُوزَّع الخادم كحزمة npm ويُشغَّل عادةً باستخدام npx، إما عبر stdio أو كخادم Streamable HTTP باستخدام علم --listen. ويمكن طلب رمز Bearer اختياري لوضع HTTP عبر متغير بيئة. تغطي مجموعة الأدوات إدارة الأجهزة (سرد الأجهزة، حجم الشاشة، قراءة/ضبط الاتجاه، تجاوز موقع GPS، قراءة/استبدال الحافظة)، وإدارة التطبيقات (السرد، التطبيق في المقدمة، التشغيل، الإنهاء، التثبيت، إلغاء التثبيت)، والتفاعل مع الشاشة (لقطات الشاشة، حفظ لقطات الشاشة، سرد عناصر واجهة المستخدم مع الإحداثيات، النقرات، النقر المزدوج، الضغط الطويل، السحب، تسجيل الشاشة)، والإدخال والتنقل (كتابة النص، الأزرار الفعلية، فتح عناوين URL)، والسجلات وتقارير الأعطال (سجلات الجهاز، سرد الأعطال واسترجاعها). تشغّل أداة أوامر الدفعات عدة أدوات بالتسلسل في نداء واحد. وتتيح أدوات الأجهزة البعيدة تسجيل الدخول إلى مزوّد سحابي، وسرد الأجهزة السحابية وتخصيصها وتحريرها. يركّز المشروع على منهج يضع إمكانية الوصول أولاً: فهو يشغّل التطبيقات من شجرة إمكانية الوصول الأصلية بدلاً من نموذج رؤية، مع الرجوع إلى لقطات الشاشة والإحداثيات عند الحاجة، وهو ما يقدّمه ملف README على أنه أسرع وأرخص من الأساليب المعتمدة على لقطات الشاشة فقط. ويوصَف الإخراج بأنه منظَّم وحتمي. تشمل المتطلبات المسبقة أدوات سطر أوامر Xcode، وأدوات منصة Android، وNode.js الإصدار 20 أو أحدث، ووكيلاً أو نموذجاً قادراً على MCP. وتُقدَّم أمثلة تهيئة للعديد من العملاء، بما في ذلك Amp وAntigravity وCline وClaude Code وClaude Desktop وCodex وCopilot وCursor وGemini CLI وGoose وKiro وopencode وWindsurf. تتحكم متغيرات البيئة في المصادقة، وإلغاء الاشتراك في القياس عن بُعد، ومخططات URL غير الآمنة، ووضع robot القديم. ويُجمَع القياس المجهول افتراضياً ويمكن تعطيله. يشير المستودع أيضاً إلى مشاريع ذات صلة: mobilewright لاختبارات الجوال الحتمية القابلة للتكرار، وmobilecli كواجهة سطر أوامر الأساسية للأجهزة، وعرض سحابي لأجهزة حقيقية عند الطلب. وترتبط به الوثائق وخارطة طريق وإرشادات المساهمة ومدونة سلوك. يذكر ملف README أن الخادم يعمل محلياً ويتواصل فقط مع الأجهزة المتصلة، مع سياسة خصوصية منفصلة لتفاصيل جمع البيانات.