كيفية إعداد Cocos Creator MCP مع Cursor وClaude (فيديو تعليمي)

شاهد الفيديو التعليمي

الفيديو: شرح إعداد Cocos Creator MCP على قناة VberAI على يوتيوب

هذا التسجيل هو دليل عملي لإعداد Cocos Creator MCP — وليس نظرة عامة على محركات متعددة. ستشاهد كيفية تثبيت البرنامج المساعد MCP، وتشغيل الجسر المحلي، وربط عميل ذكاء اصطناعي مثل Cursor أو Claude Desktop بحيث يمكن للمساعد قراءة وتعديل مشروع Cocos Creator الخاص بك داخل المحرر.

ما الذي ستتعلمه

بعد متابعة الفيديو وقائمة التحقق أدناه، يجب أن تكون قادرًا على:

• تثبيت وتفعيل البرنامج المساعد Cocos Creator MCP للإصدار 2.x أو 3.x
• تشغيل خادم MCP المحلي / الجسر من لوحة البرنامج المساعد
• إضافة الخادم إلى Cursor أو Claude أو Windsurf أو أي عميل متوافق مع MCP
• إجراء اختبار قراءة فقط (شجرة المشهد) واختبار كتابة صغير (إنشاء أو إعادة تسمية عقدة)

بروتوكول سياق النموذج (MCP) يكشف حالة المحرر المباشرة — المشهد الحالي، التسلسل الهرمي للعقد، التحديد — وليس فقط الملفات على القرص. لهذا السبب يهم إعداد MCP لسير عمل الألعاب.

المتطلبات الأساسية

العنصر	ملاحظات
Cocos Creator	مشروع 2.x أو 3.x مفتوح في المحرر
البرنامج المساعد MCP	امتداد Cocos Creator MCP (يستخدم الفيديو إصدار VberAI Cocos MCP)
عميل الذكاء الاصطناعي	Cursor أو Claude Desktop أو Claude Code أو Windsurf أو Cline أو أي مساعد يدعم MCP
الوصول المحلي	يعمل جسر MCP على 127.0.0.1؛ يجب أن يسمح جدار الحماية بحركة المرور على الحلقة المحلية

خطوات الإعداد (تابع مع الفيديو)

1. تثبيت البرنامج المساعد Cocos Creator MCP

1. قم بتنزيل امتداد MCP لإصدار Creator الخاص بك من مزود البرنامج المساعد (انظر تنزيلات Cocos MCP).
2. قم باستيراد أو نسخ الامتداد إلى مجلد extensions في مشروعك، أو قم بتثبيته عبر مدير امتدادات Creator — وفقًا لما تحدده وثائق البرنامج المساعد.
3. افتح Extension → Extension Manager، وقم بتمكين البرنامج المساعد MCP، وأعد تحميل المحرر إذا طُلب منك ذلك.

2. تشغيل جسر MCP

افتح لوحة تحكم البرنامج المساعد (يختلف اسم القائمة حسب الإصدار — غالبًا MCP أو AI Bridge):

• انقر فوق Start Server / Start MCP
• لاحظ عنوان URL المحلي والمنفذ المعروضين في اللوحة (ستلصق هذا في عميل الذكاء الاصطناعي الخاص بك)

أبقِ Cocos Creator قيد التشغيل أثناء تنشيط الجسر.

3. تكوين عميل الذكاء الاصطناعي الخاص بك

أضف إدخال خادم MCP يشير إلى عنوان URL للجسر من الخطوة 2. مثال على الشكل لـ Cursor (mcp.json):

{
  "mcpServers": {
    "cocos-mcp": {
      "url": "http://127.0.0.1:PORT/mcp"
    }
  }
}

استبدل PORT بالقيمة من واجهة البرنامج المساعد. تتضمن العديد من إصدارات Cocos MCP زر Configure for Cursor / Claude ينسخ JSON الصحيح — استخدمه عند توفره.

أعد تشغيل أو أعد تحميل عميل الذكاء الاصطناعي بعد حفظ التكوين.

4. التحقق من الاتصال

في Cursor أو Claude، اطرح سؤال قراءة فقط أولاً:

• “قائمة شجرة عقد المشهد الحالي.”
• “ما العقد الموجودة تحت Canvas؟”

يجب أن تحصل على مسارات منظمة من المحرر — وليس محتويات ملفات مخمنة.

5. جرب عملية كتابة صغيرة واحدة

اطلب تغييرًا قابلًا للعكس:

• إنشاء عقدة فرعية فارغة تحت التحديد
• إعادة تسمية مجموعة واجهة مستخدم ذات اسم سيئ
• إرفاق مكوّن أو سكربت أساسي

تأكد من ظهور التغيير في لوحة Hierarchy قبل تشغيل مهام أتمتة أكبر.

لماذا يتفوق MCP على البرمجة بالذكاء الاصطناعي القائمة على الملفات فقط

بدون MCP، يرى المساعدون الملفات على القرص فقط. يفوتهم:

• تغييرات المشهد غير المحفوظة والتحديد الحالي
• خصائص العقد الحية وقيم المكونات
• سياق المحرر فقط (وضع الجاهز، إعدادات البناء، إلخ.)

يرسل MCP حقيقة المحرر إلى النموذج، وهذا هو الهدف من إعداد Cocos Creator MCP. للتعمق المكتوب في بنية جسر مماثلة، انظر كيف بنينا خادم MCP في الوقت الفعلي لـ Godot.

ادمج MCP مع أدوات التصميم إلى واجهة المستخدم (اختياري)

يتعامل MCP مع عمليات المحرر بعد وجود الأصول. أدوات مثل VberAI Studio (AI Studio) تتعامل مع PSD / Figma → بنية واجهة محرك لـ Unity أو Godot أو Cocos. مجموعة شائعة:

1. AI Studio يستورد شاشة متعددة الطبقات ويصدر تخطيط عقد / جاهز Cocos
2. Cocos MCP يربط الأزرار، ويعيد تسمية العقد، ويتحقق من المراجع في Creator

انظر أيضًا: أنشئ واجهة مستخدم للعبة في 3 دقائق مع AI Studio.

الأسئلة الشائعة

كيف أقوم بتوصيل Cursor بـ Cocos Creator؟
ثبّت Cocos Creator MCP، وشغّل الجسر المحلي في المحرر، وأضف عنوان URL للجسر إلى mcp.json في Cursor تحت mcpServers، ثم اختبر باستخدام موجه شجرة المشهد.

ما هو Cocos Creator MCP؟
برنامج مساعد لبروتوكول سياق النموذج يسمح لعملاء الذكاء الاصطناعي بقراءة وتعديل مشاريع Cocos Creator من خلال المحرر قيد التشغيل.

أي عملاء الذكاء الاصطناعي يعملون مع Cocos MCP؟
أي عميل متوافق مع MCP: Cursor وClaude Desktop وClaude Code وWindsurf وCline وغيرها.

هل يغطي الفيديو Unity أو Godot؟
لا — يركز هذا التسجيل على إعداد Cocos Creator MCP فقط. لـ Unity، انظر دليل تثبيت Unity MCP؛ لـ Godot، انظر Godot MCP مقابل البرمجة اليدوية.

أين الفيديو الرسمي؟
يوتيوب: إعداد Cocos Creator MCP، القناة @vber_ai. اشترك في قناة VberAI على يوتيوب لمزيد من دروس MCP.