Chrome DevTools MCP

تتضمن الحاوية خادم Chrome DevTools MCP مُعدّ مسبقاً يمنح Claude Code إمكانيات أتمتة المتصفح بدون واجهة. يمكنك التنقل في صفحات الويب، والتقاط لقطات الشاشة، وفحص DOM، والتفاعل مع عناصر الصفحة — دون الحاجة إلى أي إعداد إضافي.

كيف يعمل

يُطلق نقطة الدخول متصفح Chrome مستمر بدون واجهة مع تصحيح الأخطاء عن بُعد على المنفذ 9222. يتم تسجيل خادم chrome-devtools-mcp MCP في إعدادات Claude Code ويتصل بهذا المتصفح المشترك عبر --browserUrl. تشترك جميع الجلسات في مثيل متصفح واحد وحاوية ملفات تعريف الارتباط — تستمر عمليات تسجيل الدخول وملفات تعريف الارتباط والمصادقة عبر المشاريع.

الأدوات المتاحة

الأداة	الوصف
navigate_page	التنقل إلى عنوان URL والانتظار حتى تحميل الصفحة
take_screenshot	التقاط لقطة شاشة بصيغة PNG للصفحة الحالية
take_snapshot	الحصول على لقطة شجرة إمكانية الوصول للصفحة
click	النقر على عنصر في الصفحة
type	كتابة نص في حقل إدخال
hover	التمرير فوق عنصر
scroll	تمرير الصفحة أو عنصر محدد
evaluate	تنفيذ JavaScript في سياق الصفحة
get_console_logs	استرداد رسائل سجل وحدة التحكم
get_page_info	الحصول على البيانات الوصفية للصفحة (العنوان، عنوان URL، إلخ.)

البنية المعمارية

تستخدم حزمة المتصفح أربعة مكونات تعمل معاً:

1. Playwright Chromium — ملف Chromium الثنائي المتوافق مع ARM64 يُثبَّت وقت البناء عبر npx playwright install --with-deps chromium
2. رابط Chrome الرمزي — يربط المسار المتوقع لـ Puppeteer (/opt/google/chrome/chrome) بملف Playwright الثنائي
3. عملية Chrome المشتركة — تُطلق بواسطة chrome-browser.sh مع --remote-debugging-port=9222، وتُعاد تشغيلها تلقائياً عند التعطل
4. تسجيل MCP العام — يسجل settings.json خادم chrome-devtools-mcp مع --browserUrl=http://localhost:9222

لا يتوفر لدى Google Chrome حزمة .deb لمعمارية ARM64، وحزمة chromium-browser في Ubuntu 24.04 عبر apt تُعيد التوجيه إلى snap (الذي لا يعمل في الحاويات). يُعد Chromium المُجمّع مع Playwright الخيار الوحيد الموثوق لحاويات ARM64.

التحقق

تأكد من أن الإعداد يعمل داخل الحاوية:

# Chrome binary responds
/opt/google/chrome/chrome --version

# Symlink is correct
ls -la /opt/google/chrome/chrome

# Remote debugging is active
curl http://localhost:9222/json/version

# Self-test includes Chrome checks
claude-self-test

الوضع بواجهة (VNC)

عندما يكون ENABLE_VNC=true، تبدأ نقطة الدخول حزمة VNC قبل تشغيل Chrome. يكتشف سكربت chrome-browser.sh أن DISPLAY مُعيَّن ويُشغّل Chrome في الوضع بواجهة على الشاشة الافتراضية، بحيث يمكنك رؤية المتصفح في عارض VNC.

افتح http://localhost:6080/vnc.html لرؤية الشاشة الافتراضية. راجع العرض عن بُعد (noVNC) للتفاصيل.

استكشاف الأخطاء وإصلاحها

راجع استكشاف الأخطاء وإصلاحها — Chrome DevTools MCP للحصول على حلول للمشكلات الشائعة بما في ذلك فشل تصحيح الأخطاء عن بُعد، وأخطاء قفل الملف الشخصي، وأدوات MCP المكررة.