Install
npx add-mcp next-devtools-mcp@latestلمن يناسب
يناسب من يشغّل أصلًا خادم تطوير Next.js 16+ ويريد أن يرى وكيل ترميز (أمثلة الأدلة Claude وCursor) أخطاء التشغيل والمسارات والسجلات مباشرة. الأدلة تنص: next-devtools-mcp موصل رقيق؛ يكتشف خوادم تطوير Next.js 16+ المحلية ويُمرّر نقطة MCP المدمجة /_next/mcp.
يجب أن يكون لديك أصلًا Node.js v20.19 أو LTS أحدث، مع npm أو pnpm. يتطلب nextjs_index / nextjs_call أيضًا أن يكون خادم التطوير قيد التشغيل. بلا عملية Next 16+ قيد التشغيل لا تتوقع أدوات وقت التشغيل.
لم تعد الوثائق ومسارات الترحيل تعيش في هذا الخادم: الوثائق في node_modules/next/dist/docs/؛ ويُوزَّع upgrade / Cache Components كـ agent skills.
إكمال أول محاولة في 3 دقائق
اتبع أمر التثبيت في الصفحة (لا تجعل JSON اليدوي مسارًا رئيسيًا ثانيًا في الوقت نفسه):
npx add-mcp next-devtools-mcp@latest
أضف -y لتخطي الموجه والتثبيت على كل الوكلاء المكتشفين؛ أضف -g للتثبيت العام عبر المشاريع. إعداد العميل المكافئ هو npx -y next-devtools-mcp@latest للمقارنة فقط؛ المحاولة الأولى تتبع add-mcp.
الشروط المسبقة: لديك أصلًا مشروع Next.js 16+ محليًا وnext dev قيد التشغيل. سيكتشف هذا خادم التطوير المحلي ويقرأ معلومات وقت التشغيل؛ ليست صندوق رمل بلا شبكة وبلا مشروع محلي.
موضع الإعداد: يكتب add-mcp في عملاء MCP المكتشفين؛ أو يدويًا تحت mcpServers.next-devtools للعميل.
أول استدعاء منخفض المخاطر: استدعِ أولًا nextjs_index لاكتشاف خوادم التطوير قيد التشغيل وسرد أدوات MCP لوقت التشغيل لكل منها. لا تستدعِ nextjs_call أولًا لتفعيل Server Actions. nextjs_docs وbrowser_eval بوابتان وليسا عاملَين ينجزان العمل.
إشارة النجاح: يسرد nextjs_index خادم Next.js 16+ واحدًا على الأقل قيد التشغيل وأدوات وقت تشغيله. إن كانت القائمة فارغة فأشغّل dev server أولًا؛ لا تنتقل إلى أتمتة المتصفح.
حالات الاستخدام
الحالة 1: أكّد هل يرى الوكيل خادم التطوير الحالي. استدعِ nextjs_index. تضمن الأدلة أنه يكتشف الخوادم قيد التشغيل ويسرد أدوات MCP لوقت التشغيل لكل منها؛ ولا تكتب نطاق مسح منافذ ولا معاملات اختيار مشاريع متعددة. ما يمكنك تأكيده: ترى الخوادم المكتشفة الآن.
الحالة 2: اقرأ الأخطاء أو المسارات أو السجلات على خادم مكتشف أصلًا. بعد nextjs_index استدعِ nextjs_call. تنص الأدلة أن القدرات القابلة للاستدعاء تشمل errors وroutes وlogs وServer Actions. الثلاث الأولى رصدية؛ قد تغيّر Server Actions حالة التطبيق. في المرة الأولى خذ errors/routes/logs فقط؛ لا تستدعِ Server Actions أولًا. nextjs_docs يوجّه الوكيل فقط إلى node_modules/next/dist/docs/ المطابق للإصدار.
حدود الاستخدام
هذا وكيل تمرير وليس موقع وثائق Next كاملًا ولا جسم أتمتة المتصفح. يشير browser_eval فقط إلى CLI agent-browser. لم تعد الوثائق والترحيل يعيشان هنا. تعتمد أدوات وقت التشغيل على Next.js 16+ وdev server قيد التشغيل. الأدلة لا تكتب حقول معاملات nextjs_call وليس لها مسار تراجع لـ Server Actions. لا تعامل استعلام سجل للقراءة فقط وتفعيل Server Actions كخطر واحد.