Windows MCP

Name: Windows MCP MCP Server
Author: CursorTouch

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

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

الوصول إلى شجرة UI Automation — منظم، لا يعتمد على البكسل فقط
لقطة شاشة + نقر + كتابة + اختصارات لوحة المفاتيح
تعداد النوافذ وتركيز الفوكس
إطلاق العمليات وإنهاؤها
قراءة/كتابة الحافظة
يعمل على Windows 10/11؛ لا يتطلب صلاحيات مدير للتطبيقات الأغلب

عرض مباشر

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

windows-mcp-cursortouch.replay ▶ جاهز

0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "windows-mcp-cursortouch": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "windows-mcp-cursortouch": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "windows-mcp-cursortouch": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "windows-mcp-cursortouch": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "windows-mcp-cursortouch",
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "windows-mcp-cursortouch": {
      "command": {
        "path": "uvx",
        "args": [
          "windows-mcp"
        ]
      }
    }
  }
}

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

claude mcp add windows-mcp-cursortouch -- uvx windows-mcp

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

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

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

أتمتة تطبيق Windows داخلي قديم لا يملك API

👤 مهندسو RPA المتعبون من تراخيص UiPath ⏱ ~60 min advanced

متى تستخدمه: لن يعرض مورِّد التطبيق الداخلي API؛ تحتاج من Claude إدخال البيانات اليومية.

المتطلبات الأساسية

Windows 10/11 مع التطبيق المستهدف مُثبَّتاً — تثبيت قياسي
Python 3.10+ لـ uvx — winget install Python.Python.3.12

الخطوات

فحص شجرة UI

Launch the app BookingSystem.exe, then dump the UI tree of the main window. I want to see automation IDs.✓ تم النسخ

→ تُظهر الشجرة عناصر التحكم بـ AutomationId — لا مجرد أزرار مجهولة
تشغيل المسار الطبيعي مرة واحدة

Now: open the New Booking dialog, fill customer 'Acme Inc', date 2026-05-12, save. Take a screenshot at the end.✓ تم النسخ

→ الحجز محفوظ؛ لقطة الشاشة تؤكد
التعميم والتكرار

Read /work/bookings.csv. For each row, repeat the booking flow. Save screenshots into /work/runs/.✓ تم النسخ

→ كل صف مُعالَج؛ لقطة شاشة لكل حجز

النتيجة: أتمتة بدون واجهة مستخدم لتطبيق المورِّد، قابلة للإعادة من CSV.

المزالق

التطبيق يستخدم عناصر تحكم مخصصة (مثلاً WinForms ListView بلا AutomationId) — ارجع إلى النقر بالإحداثيات على موضع ثابت في النافذة؛ وثِّق هشاشة هذا الأسلوب
نافذة حوار مشروط تخطف الفوكس في منتصف الحلقة — تحقق دائماً من النافذة النشطة قبل send_keys؛ أوقف إذا ظهر ما غير متوقع

اجمعها مع: filesystem

استخراج البيانات من Excel بدون Excel API

👤 المحللون حيث يرفض قسم IT تفعيل COM/Office API ⏱ ~15 min intermediate

متى تستخدمه: يمكنك فتح Excel لكن لا يمكنك برمجته.

الخطوات

فتح الملف

Launch Excel, open C:\reports\Q2.xlsx, focus the 'Sales' sheet.✓ تم النسخ

→ عنوان النافذة يُظهر اسم الملف
نسخ النطاق

Select A1:D200, copy to clipboard, then read clipboard text.✓ تم النسخ

→ جدول مفصول بعلامات tab مُعاد
حفظ CSV عبر filesystem

Parse that into rows and save to /tmp/Q2-sales.csv.✓ تم النسخ

→ CSV مُنشأ

النتيجة: بيانات Excel في شكل CSV دون تعديل COM API أو تثبيت حزم خارجية.

المزالق

تتفاوت صيغ الحافظة بين إصدارات Excel — جرِّب CSV أولاً؛ ارجع إلى TSV عبر متغيرات الحافظة

اجمعها مع: filesystem

التقاط خطأ في سطح المكتب لزميلك أثناء انشغالك

👤 المطورون الذين يتعاملون مع الدعم ⏱ ~5 min beginner

متى تستخدمه: خطأ متكرر يظهر على جهاز Windows الخاص بك وتريد لقطة شاشة نظيفة + خطوات إعادة الإنتاج.

الخطوات

إعادة الإنتاج والتقاط

Take a screenshot of the active app window. Save as bug.png.✓ تم النسخ

→ ملف PNG مكتوب
شرح الخطوات

List the last 5 user-visible UI elements you interacted with — window titles, dialog labels — so I can paste this into the ticket.✓ تم النسخ

→ خطوات إعادة إنتاج محددة على مستوى العناصر

النتيجة: تذكرة خطأ محددة النطاق دون التبديل بين التطبيقات.

المزالق

لقطة الشاشة تتضمن معلومات خاصة — اقتطع نافذة التطبيق النشطة فقط، لا سطح المكتب بالكامل

اجمعها مع: github

التركيبات

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

windows-mcp-cursortouch + filesystem

تشغيل تطبيق سطح المكتب من إدخال CSV

Read /work/orders.csv. For each row, click through the booking app.✓ تم النسخ

windows-mcp-cursortouch + github

التقاط خطأ في سطح المكتب وفتح issue

Screenshot active window, then create a GitHub issue with the PNG and reproducer steps.✓ تم النسخ

الأدوات

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

الأداة	المدخلات	متى تستدعيها	التكلفة
list_windows	(none)	البحث عن التطبيق المستهدف	free
get_ui_tree	window_id?	الاستكشاف قبل النقر	free
click	automation_id \| x,y	النقر على عنصر تحكم معروف	free
type_text	text: str	إدخال نص في الحقل المُركَّز	free
send_keys	keys: str (e.g. 'ctrl+s')	اختصارات لوحة المفاتيح / المُعدِّلات	free
screenshot	window_id?, region?	التأكيد البصري	free
launch_process	exe: str	تشغيل التطبيق المستهدف	free
read_clipboard	(none)	بعد النسخ	free

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

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

حصة API: لا شيء — أتمتة محلية
الرموز لكل استدعاء: 50–500 (تفريغات شجرة UI قد تكون أكبر)
التكلفة المالية: مجاني مفتوح المصدر
نصيحة: تجنَّب تفريغ شجرة UI الكاملة في كل خطوة — قيِّد بـ window_id

الأمان

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

الحد الأدنى من الصلاحيات: control of the local desktop session

تخزين بيانات الاعتماد: لا شيء — لكن Claude يرى كل ما على الشاشة

نقل البيانات الخارجي: محلي؛ لا شيء يغادر الجهاز إلا إذا منحت أيضاً MCP شبكة

لا تمنح أبدًا: administrator account auto-launch remote access pairing

لا تشغِّل على جهاز تطوير فيه بيانات اعتماد حساسة مفتوحة في تبويبات المتصفح — لقطات الشاشة قد تلتقطها
راجع شجرة UI دائماً قبل إصدار النقرات؛ تحقق من النافذة المستهدفة قبل send_keys

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

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

Control not found by automation_id

التطبيق يستخدم معرِّفات ديناميكية أو بلا معرِّفات. استخدم get_ui_tree وطابق بالاسم/التسلسل الهرمي للدور

تحقق: Inspect with Microsoft inspect.exe

Clicks land on wrong window

استدعِ set_focus على النافذة المستهدفة دائماً قبل click؛ تحقق من النافذة النشطة بعدها

uvx install fails with 'wheel' error

ثبِّت Visual C++ Build Tools؛ بعض تبعيات pywin32 تحتاجها

البدائل

Windows MCP مقابل البدائل

البديل	متى تستخدمها	المقايضة
Anthropic Computer Use (pixel)	تحتاج تحكماً عبر المنصات قائماً على البكسل	أقل موثوقية على Windows مقارنة بـ UIA؛ أكثر هشاشة عند تغير التخطيطات
AutoIt / PowerShell	تكتب نصوصاً برمجية خارج LLM	لا طبقة وكيل؛ برمجة يدوية فقط
Peekaboo (macOS)	أنت على macOS لا Windows	نظام تشغيل مختلف؛ لا يمكن الاستبدال

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

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

عرض مباشر

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

التثبيت

اختر العميل

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

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

أتمتة تطبيق Windows داخلي قديم لا يملك API

المتطلبات الأساسية

الخطوات

المزالق

استخراج البيانات من Excel بدون Excel API

الخطوات

المزالق

التقاط خطأ في سطح المكتب لزميلك أثناء انشغالك

الخطوات

المزالق

التركيبات

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

الأدوات

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

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

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

الأمان

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

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

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

البدائل

Windows MCP مقابل البدائل

المزيد

الموارد