عن المشروع

Playwright MCP هو خادم بروتوكول سياق النموذج (MCP) الذي يكشف أتمتة المتصفح عبر Playwright. بدلاً من الاعتماد على لقطات الشاشة أو النماذج المضبوطة للرؤية، فإنه يسمح لعملاء LLM بالتفاعل مع صفحات الويب باستخدام لقطات وصول منظمة، والتي يصفها المشروع بأنها سريعة وخفيفة الوزن وصديقة لـ LLM وحتمية. يقارن ملف README بين خادم MCP ونهج Playwright CLI المنفصل مع SKILLs. ويشير إلى أن وكلاء البرمجة غالبًا ما يفضلون سير العمل القائم على CLI لأنهم أكثر كفاءة في استخدام الرموز، بينما يظل MCP مفيدًا للحلقات الوكيلة التي تحتاج إلى حالة دائمة، واستبطانًا غنيًا، وتفكيرًا تكراريًا في بنية الصفحة، مثل الأتمتة الاستكشافية أو الاختبارات ذاتية الإصلاح أو سير العمل الذاتي الطويل. المتطلبات هي Node.js 18 أو أحدث وعميل MCP مثل VS Code أو Cursor أو Windsurf أو Claude Desktop أو Goose أو Grok أو Junie أو غيرها. يتم التثبيت عادةً باستخدام npx @playwright/mcp@latest، ويوفر ملف README مقاطع إعداد خاصة بكل عميل للعديد من الأدوات بما في ذلك VS Code وCursor وClaude Code وClaude Desktop وCline وCodex وCopilot وFactory وGemini CLI وGoose وGrok وJunie وKiro وLM Studio وopencode وQodo Gen وWarp وWindsurf. التكوين واسع النطاق. تغطي خيارات سطر الأوامر ومتغيرات البيئة المطابقة اختيار المتصفح (chrome، firefox، webkit، msedge)، والوضع بدون رأس، وحجم منفذ العرض، ومحاكاة الجهاز، ومحاكاة الجوال، وإعدادات الوكيل، ونقاط نهاية CDP، والمهلات، ومستويات وحدة التحكم، وسمات test-id، والأذونات، وأدلة الإخراج، وملفات الأسرار، وحفظ الجلسة، وأنماط اللقطات ومربعاتها، وحظر عامل الخدمة، ومعالجة أخطاء HTTPS، وتبديل بيئة الحماية، والمزيد. يمكن أيضًا توفير ملف تكوين JSON باستخدام --config. تدعم معالجة ملفات تعريف المستخدم ملف تعريف دائم مخزن في مواقع ذاكرة التخزين المؤقت الخاصة بالمنصة ومفتاحه بواسطة تجزئة مساحة العمل، وجلسات معزولة تتجاهل حالة التخزين عند الإغلاق، والاتصال بمتصفح موجود عبر امتداد Playwright Chrome. يمكن توفير الحالة الأولية من خلال دليل بيانات المستخدم، أو ملف حالة التخزين، أو ملف TypeScript لصفحة init يتم تقييمه على كائن صفحة Playwright، أو ملفات JavaScript لسكريبت init يتم تقييمها قبل سكريبتات الصفحة.