Skip to main content
Glama

TapMesh

تطبيق Mac أصلي لعرض أجهزة iPhone وiPad ومحاكيات iOS والتحكم بها، مع واجهة يدوية وربط MCP. تعمل الواجهة وخادم HTTP/MCP وOCR والتخزين محليًا على Mac الخاص بكل مستخدم. المشروع مفتوح المصدر بترخيص GPL-3.0-or-later؛ راجع LICENSE وNOTICE.

المصدر العام: khaled1174/TapMesh. الحزمة الحالية مرشح اختبار داخلي؛ لم تُنشر نسخة ثنائية معتمدة بعد. تفاصيل الأنظمة المدعومة وحالة النشر في RELEASE_STATUS.

المتطلبات والتشغيل

  • Mac بمعالج Apple Silicon وmacOS 15 أو أحدث.

  • Xcode وأدواته، مع runtime مناسب إذا أردت استخدام المحاكيات.

  • للأجهزة الحقيقية: الثقة بالـMac، وتفعيل نمط المطوّر، وفتح القفل عندما يطلب النظام ذلك.

تتضمن الحزمة Python والمكتبات ومساعد التحكم؛ لا يحتاج المستخدم تثبيت Python أو uv أو Docker أو إعداد SSH. بعد توفر الإصدار المعتمد، انقل TapMesh.app إلى التطبيقات وافتحه. ينشئ التطبيق ملفه المحلي ومفاتيحه داخل ~/Library/Application Support/TapMesh/Local، وتستمع الخدمات إلى loopback فقط.

اختر الجهاز صراحةً من الشريط الجانبي. تعرض الواجهة صورة الجهاز والعناصر والتطبيقات والبناء والتسجيل والملفات والنشاط والموافقات. امنح مجلدات مشاريعك من الإعدادات قبل البناء. إغلاق النافذة يترك خدمات التطبيق متاحة؛ إنهاء التطبيق يوقف خدماته المملوكة له.

Related MCP server: sim-mirror

ربط MCP

توجد 50 أداة بعقود مغلقة في Contracts/catalog.py. أضف الأمر المضمّن إلى عميل MCP:

{
  "mcpServers": {
    "tapmesh": {
      "command": "/Applications/TapMesh.app/Contents/MacOS/tapmesh-mcp"
    }
  }
}

عدّل المسار إذا ثبّت التطبيق في مجلد آخر. يبدأ الأمر التطبيق تلقائيًا ويقرأ الاتصال المحلي؛ لا تنسخ المفاتيح إلى إعدادات العميل. لكل عميل اختيار جهاز مستقل. يستطيع عميل HTTP استخدام /mcp مع إعداداته المحلية ومصادقة Bearer. لا يحصل عميل النموذج على صلاحية الموافقة المحلية.

التحكم والخصوصية

يعرض كل جهاز قدراته الفعلية؛ وجود الأداة في MCP لا يعني أن جميع الأجهزة تدعمها. ترتبط الإحداثيات والمراجع بملاحظة حديثة وحالة الاتصال. يرفض التطبيق المرجع القديم، ولا يعيد تلقائيًا عملية قد تكون وصلت قبل انقطاع الاتصال.

يفصل الفاحص بين عناصر الوصول ونتائج OCR. يذكر OCR مصدره ويعيد النصوص والمواضع دون اختراع أدوار وصول. تستخدم النسخة المحلية إطار Vision على Mac، وتختلف اللغات المتاحة بحسب النظام. بعض مسارات وصول idb على Xcode 27 تعيد نتائج غير صالحة بعد إعادة تشغيل التطبيق؛ يظهر ذلك كقدرة متدهورة ويظل OCR متاحًا عند نجاحه.

تتطلب العمليات الحساسة موافقة مرتبطة بالجلسة والجهاز والمعاملات والمدة. لا يدخل التطبيق رمز قفل الجهاز أو يتجاوز المصادقة. لا تعني نتيجة إرسال الضغط نجاح عملية داخل التطبيق.

يمكن تصدير تقرير تشخيص محلي من الإعدادات. يتضمن نسخ التطبيق وحالة الخدمات والأعداد ومراجع أخطاء محدودة، ويستبعد مفاتيح الاتصال ومحتوى الشاشة والنصوص المدخلة ومعرّفات الأجهزة ومسارات المستخدم.

البناء والمساهمة

راجع SOURCE_BUILD للبناء والاختبارات، وDEPENDENCY_SOURCES للمصدر المقابل للمكتبات، وPRODUCT_SCOPE لنطاق المنتج. الاختبارات الحقيقية اختيارية وصريحة، ولا يُحسب الاختبار المتخطى نجاحًا.

تبقى بيئة TNAS الخاصة بالمالك اتصال تطوير اختياريًا في الإعدادات المتقدمة. لا تعتمد نسخة المستخدمين عليه، ولا تتضمن عنوانه أو مفاتيحه أو أجهزة المالك. يمكن للمطوّر إعداد اتصال خاص باستخدام scripts/manage.py --help.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables mirroring and controlling the iOS Simulator from MCP clients, providing a live viewer, agent cursor tracking, and token-efficient UI snapshots for automation.
    551 PyPI
    2
    Apache 2.0
  • A
    license
    A
    quality
    B
    maintenance
    Enables a macOS MCP client to control a real iPhone through CoreDevice services, including screenshots, normalized taps and swipes, text entry, hardware-button presses, and app launching or listing.
    11
    MIT
  • A
    license
    B
    quality
    B
    maintenance
    Drives a physical iPhone or iPad over Appium and WebDriverAgent (XCUITest) from a Mac, letting an agent inspect the screen, tap, type, swipe, launch apps, and run Shortcuts. Safe-by-default access modes, app allowlists, and elicitation-gated destructive operations keep admin actions behind explicit approval.
    6
    59 npm
    MIT