Chrome DevTools MCP (chrome-devtools-mcp) خادم MCP يمنح وكيل برمجة التحكم في متصفح Chrome حقيقي: فتح صفحة، وقراءة وحدة التحكم (console) والشبكة، وتسجيل تتبع للأداء. يضم مستودع ChromeDevTools/chrome-devtools-mcp نحو 53 700 نجمة في منتصف أكتوبر 2026، وآخر إصدار معروض له هو v1.11.0 بتاريخ 15 أكتوبر.
بالنسبة إلى مهندس SRE، الفائدة مزدوجة. يستطيع الوكيل إصلاح مشكلة في العرض بمشاهدة ما يراه المتصفح بدل التخمين انطلاقًا من الشيفرة. وينتج قياسات لأداء الويب (LCP وINP وCLS) يمكن مقارنتها بقياسات المستخدمين الفعليين. يتبع هذا المقال README ووثائق المشروع: التثبيت، والأدوات المفيدة، وإعدادات الخصوصية، ثم موضع هذه القياسات إلى جانب RUM.
توضيح للأمانة: لم تشغّل span.observer هذا الخادم من أجل هذا المقال. الأوامر مأخوذة من وثائق المستودع، واللقطات مقتطفات معروضة انطلاقًا من ملفاته.
Chrome DevTools MCP: ما يقوله المستودع
- الناشر والترخيص: منظمة ChromeDevTools على GitHub، بترخيص Apache-2.0 (ملف LICENSE).
- اللغة: TypeScript؛ ويُبنى
package.jsonبالأداةtsc. - أرقام قُرئت في 16 أكتوبر 2026: نحو 53 700 نجمة، ونحو 6 900 تفرّع (fork)، و1 437 إيداعًا (commit)، والإصدار v1.11.0.
- الوظائف المعلنة: رؤى (insights) للأداء انطلاقًا من تتبعات DevTools، وتصحيح الأخطاء (الشبكة ولقطات الشاشة ورسائل وحدة التحكم مع مكدسات مرتبطة بـ source maps)، وأتمتة موثوقة عبر Puppeteer. وتوجد أيضًا أداة CLI تجريبية دون MCP.
- النطاق الرسمي: Google Chrome وChrome for Testing. وقد تعمل متصفحات Chromium الأخرى دون ضمان.
لا يعتمد الخادم على أي منتج من Dynatrace. وتنطبق صلة قابلية الملاحظة على Dynatrace SaaS وDynatrace Managed فيما يخص RUM، مع التحفظ الوارد في قسم RUM أدناه.
التثبيت خطوة بخطوة
الخطوة 1 — المتطلبات
يطلب README نسخة LTS من Node.js، وChrome بالإصدار المستقر الحالي (أو أحدث)، وnpm.
الخطوة 2 — تصريح الخادم في عميل MCP
الإعداد الأساسي واحد لمعظم العملاء. ويقترح README أيضًا وضع --slim المقتصر على ثلاث أدوات (التنقل وتنفيذ السكربت ولقطة الشاشة) للمهام البسيطة:

بالنسبة إلى Claude Code، يعطي دليل إعدادات العملاء في المستودع هذا الأمر:
claude mcp add chrome-devtools --scope user npx chrome-devtools-mcp@latest
ويصف الدليل أيضًا تثبيتًا كإضافة (MCP وskills) بالأمر /plugin marketplace add ChromeDevTools/chrome-devtools-mcp. ملاحظة تشغيلية: يجعل @latest الإصدار الأحدث يُتّبع تلقائيًا عند كل تشغيل؛ وفي بيئة خاضعة للتحكم استبدله برقم إصدار محدد.
الخطوة 3 — الاختبار الأول
يقترح README هذا المُوجّه (prompt): «Check the performance of https://developers.chrome.com». يجب أن يفتح العميل المتصفح ويسجّل تتبعًا للأداء. ولا يبدأ المتصفح إلا عند استدعاء أداة تحتاج إليه، لا بمجرد اتصال الخادم.
قياسات أداء الويب بواسطة وكيل
يسرد مرجع الأدوات في المستودع 59 أداة في إحدى عشرة فئة (الإدخال، والتنقل، والمحاكاة، والأداء، والشبكة، وتصحيح الأخطاء، والذاكرة، والإضافات، وأدوات الأطراف الثالثة، وWebMCP، وPWA). وفي الأداء تهم ثلاث أدوات: performance_start_trace وperformance_stop_trace وperformance_analyze_insight.

يذكر الوصف مؤشرات Core Web Vitals (LCP وINP وCLS). ويفيد معاملان في بروتوكول قياس قابل للتكرار: يعيد reload تحميل الصفحة بعد بدء التسجيل، ويتجاوز ignoreCache ذاكرة HTTP المؤقتة لقياس تحميل بارد. ويحفظ filePath التتبع الخام، ما يتيح إعادة فتحه أو أرشفته. وتتعمق performance_analyze_insight في رؤية مُشار إليها، مثل LCPBreakdown أو DocumentLatency بحسب وثائق الأداة.
ويستطيع الخادم أيضًا سرد طلبات الشبكة وقراءة وحدة التحكم وتنفيذ تدقيق Lighthouse (إمكانية الوصول وSEO وأفضل الممارسات و«agentic browsing»؛ أما الأداء فيمرّ عبر التتبع) ومحاكاة جهاز.
من المختبر إلى RUM: ما لا تقوله هذه القياسات
التتبع الذي يسجّله الوكيل قياس مخبري: متصفح واحد وشبكة واحدة وجهاز واحد. ولا يخبرك بما يعيشه مستخدموك. ويقرّ README بذلك على طريقته: يمكن لأدوات الأداء إرسال عنوان URL الخاص بالتتبعات إلى CrUX API من Google لعرض بيانات ميدانية إلى جانب البيانات المخبرية، ويعطّل الخيار --no-performance-crux هذا الإرسال.
وتوزيع الأدوار الناتج سليم لمهندس SRE: يشخّص الوكيل ويتحقق من إصلاح في المختبر؛ ويؤكد RUM أن هدف مستوى الخدمة (SLO) يتحقق للزوار الفعليين. وللجانب الثاني راجع RUM في Dynatrace وCore Web Vitals وSession Replay على Grail (RUM على Grail: Dynatrace SaaS؛ وفي Dynatrace Managed يبقى RUM الكلاسيكي متاحًا دون Grail). ويجب أن يظهر التراجع الذي يصلحه الوكيل في منحنى المئين 75 للمستخدمين، وإلا فإن القياس المخبري لم يكن يمثّل الواقع.
الخصوصية وضوابط الحماية
يحذّر README من أن الخادم يكشف محتوى نسخة المتصفح لعميل MCP، الذي يمكنه فحص أي بيانات في المتصفح أو DevTools وتعديلها. والخيارات المفيدة بحسب docs/configuration.md:

- ينشئ
--isolatedملفًا شخصيًا مؤقتًا يُحذف عند الإغلاق. وبدونه يكون الملف الشخصي الافتراضي مجلدًا تحت$HOME/.cache/chrome-devtools-mcp/يُحفظ بين الجلسات: فقد تبقى فيه ملفات تعريف الارتباط (cookies) وجلسات تسجيل الدخول. --no-usage-statistics: جمع Google لإحصاءات الاستخدام مفعّل افتراضيًا؛ ويتوقف إذا عُرّف المتغيرCHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICSأوCI. وتُعطَّل فحوص التحديث بالمتغيرCHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS.- يحدّ
--allowedUrlPatternو--blockedUrlPatternمن المواقع التي يستطيع المتصفح بلوغها؛ ويتطلب الأول Chrome 149 أو أحدث. - يعطّل
--no-javascript-evaluation(--javascriptEvaluation=false) تقييم السكربتات التي يقدمها المستدعي؛ وتوضح الوثائق أن هذا ليس عزلًا (sandbox).
مراقبة ما يفعله الوكيل في المتصفح
يكتب الخيار --logFile سجلات تصحيح الخادم في ملف، مع NODE_DEBUG=* لأقصى درجات التفصيل. وهذا يساعد على تشخيص الخادم، لا على تدقيق الوكيل. وللتدقيق، تتبّع استدعاءات الأدوات من جهة العميل عبر OpenTelemetry: span باسم tools/call performance_start_trace بحسب اصطلاحات MCP (حالة Development)، وأحداث أدوات وكيل البرمجة. والمنهج في مراقبة وكلاء MCP عبر OpenTelemetry ومراقبة وكيل برمجة في المؤسسة. وينطبق المنطق نفسه على خادم GitHub MCP.
كيف تتحقق من أنه يعمل
- في العميل، تتضمن قائمة الأدوات
performance_start_traceوtake_screenshot. - يفتح مُوجّه الاختبار Chrome ويعيد ملخص تتبع مع Core Web Vitals.
- مع
--isolatedلا يظهر أي ملف شخصي دائم في~/.cache/chrome-devtools-mcp/بعد الجلسة.
أفضل الممارسات
- استخدم ملفًا شخصيًا معزولًا وحساب اختبار: يرى الوكيل ما يراه المتصفح.
- كرّر القياس قبل الاستنتاج: تتبع واحد لا يصنع اتجاهًا.
- أبقِ البروتوكول متطابقًا (الجهاز المحاكى والذاكرة المؤقتة والشبكة) للمقارنة قبل الإصلاح وبعده.
- قارن دائمًا ببيانات المستخدمين في RUM قبل إعلان إصلاح تراجع ما.
الأسئلة الشائعة
هل يحل Chrome DevTools MCP محل أداة RUM؟
لا. فهو يقيس في المختبر على جهاز واحد؛ أما RUM فيقيس ما يعيشه مستخدموك. ويكمّل أحدهما الآخر.
ما المتصفحات المدعومة؟
يذكر README فقط Google Chrome وChrome for Testing؛ وقد تعمل متصفحات Chromium الأخرى دون ضمان.
هل يرسل الخادم بيانات إلى Google؟
بحسب README: إحصاءات استخدام (قابلة للتعطيل)، وبالنسبة إلى أدوات الأداء عناوين URL إلى CrUX API (قابلة للتعطيل بـ --no-performance-crux). تحقق من هذه الإعدادات قبل أي استخدام في المؤسسة.
الخلاصة
يضع Chrome DevTools MCP أدوات مطوّر الويب بين يدي وكيل. وباستخدامه مع ملف شخصي معزول وقياسات قابلة للتكرار وتأكيد من RUM، يقصّر الطريق بين عَرَض البطء وإصلاح جرى التحقق منه. المصادر: مستودع ChromeDevTools/chrome-devtools-mcp.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا للمشاريع المذكورة. العلامات التجارية المذكورة ملك لأصحابها. الأدوات تتطور بسرعة: تحقق من الأوامر والخيارات في وثائقها الرسمية.