عن المشروع

Windows-MCP هو خادم MCP (بروتوكول سياق النموذج) خفيف الوزن ومفتوح المصدر يربط وكلاء الذكاء الاصطناعي بنظام تشغيل Windows. يتيح للوكلاء أداء التنقل في الملفات، والتحكم في التطبيقات، والتفاعل مع الواجهة، واختبار الجودة من خلال كشف أتمتة واجهة Windows كأدوات MCP. القدرات الرئيسية: - تكامل أصلي مع Windows: يفتح التطبيقات، ويتحكم في النوافذ، ويحاكي إدخال لوحة المفاتيح والماوس، ويلتقط حالة النافذة/الواجهة. - يعمل مع أي LLM؛ لا يتطلب خط أنابيب رؤية حاسوبية تقليدية أو نموذجًا مضبوطًا، والرؤية اختيارية. - مجموعة أدوات لأتمتة الواجهة تغطي عمليات لوحة المفاتيح والماوس الأساسية ولقطات الشاشة أو الواجهة. - وضع DOM لأتمتة المتصفح: خيار `use_dom=True` على أداة الحالة يركز على محتوى صفحة الويب ويستبعد عناصر المتصفح. يدعم Chrome وEdge وFirefox (يستخدم Firefox بديل IAccessible2). - زمن الاستجابة النموذجي المبلغ عنه بين الإجراءات يتراوح تقريبًا بين 0.2 و0.5 ثانية، ويختلف مع حمل النظام وسرعة استدلال LLM. التثبيت والتشغيل: - يتطلب Python 3.13+ ومدير الحزم uv. يُوصى باللغة الإنجليزية كلغة عرض Windows؛ وإلا يجب تعطيل أداة التطبيق. - يمكن تشغيله مباشرة باستخدام `uvx windows-mcp serve`، أو تثبيته كمهمة مجدولة لكل مستخدم عبر `windows-mcp install` (مع `uninstall` لإزالته). تُخزن السجلات في `~/.windows-mcp/`. - يدعم نقل stdio (الافتراضي) وSSE وstreamable-http. تُقدم إرشادات الإعداد لـ Claude Desktop وPerplexity Desktop وGemini CLI وQwen Code وCodex CLI وAutohand Code وClaude Code، بما في ذلك جسر WSL عبر powershell.exe. الأمان والتحكم في الوصول: - مصادقة رمز الحامل، وقوائم السماح بعناوين IP مع نطاقات CIDR، وقوائم سماح اختيارية لأصول CORS، وTLS/HTTPS عبر ملفات الشهادات والمفاتيح، وOAuth 2.0 مع PKCE للعملاء المتوافقين. - اختيار الأدوات عبر قائمة السماح `--tools` أو قائمة الحظر `--exclude-tools`. - يمكن تخزين التكوين في `~/.windows-mcp/config.toml`، مع تجاوز خيارات سطر الأوامر لقيم الملف. يمكن لمساعد `auth` توليد مفاتيح وشهادات موقعة ذاتيًا. - تمنع أداة Scrape عناوين IP الخاصة، والعناوين المحلية، وعناوين link-local، والبيانات الاعتمادية في عناوين URL، والبروتوكولات غير HTTP. تغطي متغيرات البيئة تحجيم لقطات الشاشة وخلفية الالتقاط (dxcam/mss/pillow)، وملف تعريف اللقطات، وتعطيل وميض الالتقاط، وإعدادات الأمان، ووضع HTTP عديم الحالة، والقياس عن بُعد المجهول (مفعل افتراضيًا، يمكن تعطيله)، وتسجيل التصحيح. يتوفر حارس تركيز UIA لكنه معطل افتراضيًا. المشروع مرخص بموجب MIT ومنشور على PyPI وسجل MCP.