MCP

اكتشف أولًا ثم تصرّف على سطح مكتب Windows

يناسب من يريد أن يشغّل Claude أو Cursor سطح مكتب Windows 10/11. لا تخمّن إحداثيات البكسل؛ استدعِ desktop_discover أولًا وتذكّر التوقف الطارئ في الزاوية العليا اليسرى.

Official source · desktop-touch-mcp

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.