Install
npx -y @modelcontextprotocol/server-puppeteerلمن يناسب
يناسب من يحتاج أن يفتح نموذج صفحات ويب في متصفح محلي حقيقي، أو يقرأ وحدة التحكم، أو يترك لقطات. الأدلة تنص: هذا خادم MCP لأتمتة المتصفح عبر Puppeteer؛ يمكن للنموذج التفاعل مع الصفحات والتقاط لقطات وتنفيذ JavaScript في بيئة متصفح حقيقية.
يعمل على جهازك، لذا يمكنه أيضًا بلوغ ملفات محلية وعناوين IP محلية/داخلية. لا تتصل إلا إذا قبلت حدود الخصوصية هذه ويمكنك ضبط البيانات الحساسة. الأدلة لا تسرد أسماء عملاء؛ الغطاء يتوقف عند: لديك بالفعل عميل يضبط MCP ويمكنك تشغيل npx.
الصفحة الرسمية تقع تحت شجرة servers-archived. الأدلة لا تكتب حالة الصيانة أو بديلًا على حدة؛ فلا تعاملها كمنتج حالي ما زال يُحدَّث.
إكمال أول محاولة في 3 دقائق
اتبع مسار NPX المذكور في الأدلة. في إعداد MCP للعميل استخدم:
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-puppeteer"]
لا تجعل Docker مسارًا رئيسيًا في الوقت نفسه. الأدلة تضيف فقط: Docker يستخدم Chromium بلا واجهة؛ وNPX يفتح نافذة متصفح.
الشروط المسبقة: Node/npx مثبت محليًا؛ المحاولة الأولى تفتح فقط صفحة عامة يحق لك الوصول إليها دون إرسال نموذج أو تسجيل دخول. بعد التشغيل يعمل متصفح على هذا الجهاز وقد يصل إلى ملفات محلية وعناوين داخلية.
موضع الإعداد: إعداد خادم MCP في العميل (أمر stdio ووسائطه). بعد الحفظ أعد تشغيل العميل أو أعد تحميله.
أول استدعاء منخفض المخاطر: استدعِ فقط puppeteer_navigate المكتوب بالكامل في الأدلة، وتنقّل إلى URL المذكور للتو. الأدلة لا تعطي حقول المعاملات؛ ملخص collect يذكر أيضًا screenshot وclick وhover وfill وselect وevaluate، لكن تلك المحددات غير موسَّعة—لا تستدعها في المحاولة الأولى.
إشارة النجاح: في مسار NPX يجب أن ترى نافذة متصفح محلي تُفتح وتبقى على العنوان الذي أعطيته. ثم يمكنك قراءة المورد console://logs (خرج وحدة التحكم نصًا) أو screenshot://<name> (PNG). إن لم تظهر نافذة، أكّد أولًا أنك على NPX لا Docker.
حالات الاستخدام
الحالة 1: اجعل النموذج يفتح صفحة عامة محددة. استدعِ puppeteer_navigate. تضمن الأدلة فقط «التنقل إلى أي URL في المتصفح»؛ ولا تذكر المهلة أو إعادة التوجيه أو إرسال ملفات cookie المحلية. ما يمكنك تأكيده: يحدث التنقل في متصفح محلي حقيقي؛ لا تفترض جلسة سحابية معزولة.
الحالة 2: بعد فتح الصفحة راجع وحدة التحكم أو اترك لقطة. الدليل الأول يذكر اللقطات وتنفيذ JavaScript؛ ودليل الموارد يعطي console://logs (كل رسائل وحدة تحكم المتصفح) وscreenshot://<name> (PNG للقطة مُلتقطة). الأدلة لا تسمي أداة اللقطة ولا كيفية توليد <name> ولا معاملات evaluate. لذا الخطوة الثانية تقرأ هذه الموارد فقط، أو تتوقف عند «الأدلة تضمن فقط اللقطة/تنفيذ JS»—لا تخترع محددات أو سكربتات.
حدود الاستخدام
يمكن للمتصفح المحلي الوصول إلى ملفات محلية وعناوين IP محلية/داخلية وقد يُخرج بيانات حساسة. يفتح NPX نافذة مرئية؛ وDocker هو Chromium بلا واجهة. السلوك مختلف؛ لا تخلطهما ثم تعتبر النافذة إشارة نجاح. الأداة الوحيدة المسماة بالكامل هي puppeteer_navigate؛ قدرات التفاعل (نقر، تعبئة) بلا محدد بمعاملات ولها آثار جانبية على الصفحة. الموارد تسرد فقط وحدة التحكم واللقطات؛ لا يوجد تراجع ولا مسح cookie ولا إغلاق للمتصفح. الأدلة لا تعطي قائمة عملاء ولا نموذج صلاحيات ولا حزمة بديلة بعد الأرشفة.