/ الدليل / الملعب / Android-MCP
← كل الخوادم ↗ GitHub
● مجتمع CursorTouch ⚡ فوري

Android-MCP

بواسطة CursorTouch · CursorTouch/Android-MCP

قيّد جهاز Android أو محاكيًا من خلال الدردشة — اضغط، انزلق، اكتب، اقرأ الإخطارات — للأتمتة QA أو العروض التوضيحية.

يقوم Android-MCP من CursorTouch بتغليف ADB لمنح عملاء MCP إمكانية الضغط والانزلاق والكتابة ومفاتيح الأجهزة والإخطارات والوصول إلى أوامر Shell على أجهزة Android 10+. مثالي لسقالات اختبار الواجهة الرسومية والعروض التوضيحية القابلة للتكرار أو أتمتة تدفقات التطبيقات الممل. يتطلب ADB وجهاز/محاكيًا متصلاً.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

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

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

عرض مباشر

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

android.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "android": {
      "command": "uvx",
      "args": [
        "Android-MCP"
      ],
      "_inferred": true
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "android": {
      "command": "uvx",
      "args": [
        "Android-MCP"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "android": {
      "command": "uvx",
      "args": [
        "Android-MCP"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "android": {
      "command": "uvx",
      "args": [
        "Android-MCP"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "android",
      "command": "uvx",
      "args": [
        "Android-MCP"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "android": {
      "command": {
        "path": "uvx",
        "args": [
          "Android-MCP"
        ]
      }
    }
  }
}

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

claude mcp add android -- uvx Android-MCP

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

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

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

أتمتة اختبار الدخان لتطبيق Android الخاص بك

👤 مهندسو QA للجوال، فرق التطوير بدون إطار اختبار ⏱ ~30 min intermediate

متى تستخدمه: تريد 'فتح التطبيق، تسجيل الدخول، تحميل الشاشة الرئيسية' كتشغيل تلقائي قبل كل إصدار.

المتطلبات الأساسية
  • ADB مثبت والجهاز متصل — يأتي Android Studio مع ADB؛ يجب أن يظهر adb devices جهازك
  • الجهاز لديه USB debugging أو wireless debugging مفعل — الإعدادات > خيارات المطور > USB Debugging
الخطوات
  1. التقط الحالة الحالية
    احصل على حالة الواجهة الرسومية — أي شاشة أنا عليها وأي العناصر مرئية؟✓ تم النسخ
    → شجرة الواجهة الرسومية مع عناصر مع تسميات
  2. نفذ التدفق
    اضغط على زر 'Sign In'، اكتب '[email protected]' في حقل البريد الإلكتروني، 'P@ss' في كلمة المرور، قدم.✓ تم النسخ
    → التطبيق ينتقل إلى الصفحة الرئيسية
  3. تأكد من النجاح
    تحقق من أن لافتة 'Welcome' بالشاشة الرئيسية مرئية. إذا لم تكن، فشل.✓ تم النسخ
    → حكم نجح/فشل

النتيجة: اختبار دخان قابل للسكريبت يمكنك تشغيله في كل بناء.

المزالق
  • تتغير الإحداثيات بين أحجام الأجهزة — فضل استعلامات State-Tool التي تجد العناصر حسب التسمية/المعرف، ثم انقر على الإحداثيات المُرجعة
  • التدفق ينقطع على اختبارات A/B — ثبّت تكوين البناء أو عطّل التجارب لبناءات QA
اجمعها مع: github

قم بتشغيل عرض منتج قابل للتكرار على جهاز حي

👤 مهندسو المبيعات، فريق المنتج الذين يقومون بعروض المستثمرين ⏱ ~20 min intermediate

متى تستخدمه: تريد التطبيق مُشغّل بدون استخدام اليدين أثناء حديثك.

الخطوات
  1. اكتب السيناريو للعرض
    اكتب السيناريو لهذه 5 خطوات مع توقفات 3 ثواني: فتح التطبيق، اضغط على Explore، انتقل إلى الفئة B، اضغط على العنصر X، التقط لقطة شاشة.✓ تم النسخ
    → خطة الخطوات
  2. تشغيل تجريبي
    نفذ. توقف بين الخطوات حتى أتمكن من الشرح.✓ تم النسخ
    → الجهاز يتابع

النتيجة: عرض خالي من الأخطاء يمكنك إعادة تشغيله بشكل متطابق.

فرز الإخطارات على جهاز التطوير

👤 المطورون الذين يختبرون تدفقات الإخطارات ⏱ ~10 min beginner

متى تستخدمه: التحقق من وصول الإخطارات الفورية وظهورها بشكل صحيح.

الخطوات
  1. اقرأ الإخطارات الأخيرة
    اسرد الإخطارات النشطة. علم أي منها من com.myapp.prod.✓ تم النسخ
    → قائمة مُفلترة
  2. افحص واحدة
    اسحب المحتوى الكامل لآخر إخطار myapp؛ هل يطابق صيغتنا المتوقعة؟✓ تم النسخ
    → الفرق مقابل المتوقع

النتيجة: تأكيد سريع بأن خط أنابيب الضغط الخاص بك يعمل.

التركيبات

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

android + github

قم بتشغيل اختبارات الدخان على PRs ونشر النتائج

عندما يكون لـ PR #88 مصنع APK جديد، ثبت على الجهاز المتصل، قم بتشغيل تدفق اختبار الدخان، علق على النتائج في PR.✓ تم النسخ
android + filesystem

احفظ لقطات الشاشة والسجلات كمصنوعات QA

خذ لقطة شاشة بعد كل خطوة من خطوات تدفق العرض واحفظها في ./qa/2026-04-14/step-N.png.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
State-Tool (none) دائمًا أولاً — اعرف ما في الشاشة free
Click-Tool x: int, y: int اضغط على نقطة مُرجعة من State free
Long-Click-Tool x, y, duration_ms? القوائم السياقية free
Type-Tool text: str, clear_first?: bool أدخل النص في الحقل المركز عليه free
Swipe-Tool x1,y1,x2,y2, duration_ms? انتقل أو حرك free
Drag-Tool start_x,y,end_x,y تدفقات السحب والإفلات free
Press-Tool key: Back|Home|VolumeUp|... مفاتيح الأجهزة / التنقل في النظام free
Wait-Tool ms: int انتظر الرسوم المتحركة/الانتقال free
Notification-Tool (none) or package: str افحص الإخطارات free
Shell-Tool cmd: str ثغرة الهروب للسجلات وأوامر am/pm وما إلى ذلك. مجاني (لكن قوي — خطير)

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

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

حصة API
لا شيء — كل شيء محلي عبر ADB
الرموز لكل استدعاء
تعيد أداة State شجرة واجهة رسومية يمكن أن تكون 2-10k رموز على الشاشات الكثيفة
التكلفة المالية
مجاني
نصيحة
اطلب من State تصفية البحث ('find buttons with Sign In') بدلاً من تفريغ الشجرة بأكملها.

الأمان

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

تخزين بيانات الاعتماد: لا شيء؛ ثقة ADB على الجهاز
نقل البيانات الخارجي: كل شيء محلي؛ ADB عبر USB أو Wi-Fi محلي فقط
لا تمنح أبدًا: Shell-Tool على أجهزة بها بيانات الإنتاج — يمكنها قراءة الملفات الخاصة

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

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

adb: جهاز غير مصرح

اقبل موجه بصمة الإصبع على شاشة الجهاز، ثم حاول مجددًا.

تحقق: adb devices
لم يتم العثور على أجهزة

تحقق من أن USB debugging مفعل وكبل USB يدعم البيانات. لـ WiFi، تحقق من ip:port باستخدام adb connect.

تحقق: adb devices
الإحداثيات خاطئة على شاشة مختلفة

استخدم State-Tool للحصول على الإحداثيات الحالية للعنصر المُسمى بدلاً من x,y المرمزة بشكل ثابت.

تحقق: Call State before click
Type-Tool تدرج أحرف عشوائية

الجهاز يستخدم لوحة مفاتيح غير أمريكية؛ التبديل إلى US أو استخدام adb shell input text عبر Shell-Tool.

تحقق: adb shell settings get secure default_input_method

البدائل

Android-MCP مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Appiumتريد إطار عمل QA كامل مع التأكيدات والتقاريرإعداد ثقيل؛ لا توجد طبقة MCP
Maestroاختبارات الواجهة الرسومية القائمة على YAMLلا توجد تكامل MCP

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills