Install
npx -y @harusame64/desktop-touch-mcpلمن يناسب
يناسب من يريد أن يرى Claude أو Cursor أو عميل MCP آخر سطح مكتب Windows 10/11 ويشغّله. القدرات الرسمية تشمل screenshots وUI Automation وChrome CDP وkeyboard / mouse وterminal وsemantic discover-then-act، متجنّبة pixel-coordinate guessing.
هذا ليس سطح مكتب بعيدًا عبر المنصات. يجب أن يكون هذا الجهاز Windows 10/11. يكتب النص الرسمي أيضًا 32 tools وnative Rust engine (UIA in 2 ms) وzero-config PowerShell fallback وfull CJK support وMIT licensed، ويمكنه قيادة Notepad وExcel وChrome وWindows Terminal وتطبيقات محلية أخرى.
الصفحة الرسمية:
https://github.com/Harusame64/desktop-touch-mcp
إنهاء أول تجربة في 3 دقائق
اتبع الأمر الرسمي فقط:
npx -y @harusame64/desktop-touch-mcp
أضفه إلى إعداد Claude / Cursor / VS Code Copilot. لا تبحث عن مثبّت لم يظهر.
الشرط المسبق: Windows 10/11؛ هذا الجهاز يستطيع تشغيل npx. في التجربة الأولى لا تحرّك الفأرة لنقر تطبيق ولا تفتح Key Locker. تذكّر أولًا التوقف الطارئ: أبقِ الفأرة في الزاوية العليا اليسرى للشاشة الرئيسية (within 10px of 0,0) لمدة 500ms.
موضع الإعداد: إعداد MCP لتلك العملاء. النص الرسمي لا يعطي مسار ملف.
يجب أن يستخدم الاستدعاء الأول desktop_discover المذكور. يعيد interactive entities وshort-lived leases لا إحداثيات خام. النجاح: ترى الكيانات والتأجيرات ولم تسقط إدخال لوحة مفاتيح أو نقرة فأرة على نافذة.
لا تستدعِ desktop_act فورًا. ذلك سيقوم بـ operate on what you mean؛ للنص الرسمي per-action perception guards تتحقق من identity وbounds للنافذة المستهدفة قبل هبوط الإدخال، لكنه ما زال كتابة.
الاكتشاف للقراءة فقط ليس صفر مخاطر: يلتقط لقطات ويقرأ شجرة الواجهة وقد يلمس Chrome CDP. يدخل محتوى سطح المكتب المحلي إلى العميل.
حالات الاستخدام
الحالة الأولى: اكتشف أولًا ثم قرر التصرف. استدعِ desktop_discover واقرأ الكيانات والتأجيرات المعادة. النص الرسمي لا يكتب مدة التأجير ولا جدول حقول الكيان. حاليًا لا تصل إلا إلى «رؤية كائنات قابلة للتفاعل لا نقاط بكسل».
الحالة الثانية: نفّذ فعلًا على تأجير موجود. استدعِ desktop_act. يؤكّد النص الرسمي أنه يعمل على what لا where ومع perception guards ضد wrong-window typing. لا تعداد أفعال. قبل الاستدعاء يجب أن ترى نقطة تأكيد وأن تكون جاهزًا للتوقف الطارئ أعلى اليسار.
Key Locker قدرة أخرى مسمّاة: احفظ اعتمادًا مرة في مربع أمانه الخاص (تشفير Windows DPAPI، never shown to the assistant) ثم افتح وحدة تحكم بـ key_locker(action='launch_console')؛ تملأ مطالبات ssh / sudo المخفية السر تلقائيًا. لا تسلك هذا الطريق في التجربة الأولى.
حدود الاستخدام
حد المنصة: Windows 10/11. حد القدرة: الأدوات المذكورة desktop_discover وdesktop_act وkey_locker؛ كُتب 32 tools إجمالًا لكن بقية الأسماء لا تظهر.
حد الأمان: التوقف الطارئ هو أعلى يسار الشاشة الرئيسية 10px لمدة 500ms. الاعتمادات لا تُعرض للمساعد لكنها تبقى على هذا الجهاز. النص الرسمي لا يصف جلسة بعيدة ولا تراجعًا خارج Windows.