المدونة المقارنة المعجم
الموقع الرسمي
← العودة إلى المدونة

كيف تفعّل إضافة MCP في Godot: من التحميل إلى ظهور الأدوات في Cursor

فعّل Godot MCP مفتوح المصدر في Godot: حمّل الإضافة، ضعها في addons، فعّلها في إعدادات المشروع، شغّل الخادم المحلي وتأكد من godot-mcp في Cursor أو IDEs تدعم MCP.

نُشر في
  • godot
  • mcp
  • cursor
  • tutorial
  • godot-mcp
  • ai

كيف تفعّلها: ما يغطيه هذا الدليل

تفعيل إضافة MCP ليس مجرد علامة في القائمة — يلزم خادم محلي يعمل وأدوات ظاهرة في Cursor (أو IDE آخر يدعم MCP). خمس خطوات: تحميل → addons → تفعيل الإضافة → تشغيل Server → التحقق في Cursor.

عند الانتهاء ستتمكن من:

  • وضع الإضافة في addons وتفعيلها في Project Settings
  • تشغيل Godot MCP Server محليًا (المنفذ 3000 افتراضيًا)
  • استخدام الإعداد بنقرة واحدة وتأكيد godot-mcp في Cursor

قائمة تفعيل سريعة

  1. مجلد الإضافة في addons/<الاسم>/ (بدون تداخل زائد)
  2. Project Settings → Plugins: Godot MCP Server مفعّل
  3. لوحة GodotMCP تعرض Running
  4. قائمة MCP في Cursor تعرض godot-mcp (أعد التحميل إن لزم)
  5. موجّه للقراءة فقط يسرد عقد جذر المشهد النشط

المستودع: DaxianLee/godot-mcp · المنتج: Godot MCP

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

العنصرملاحظات
Godotمثبت، مع مشروع يمكنك فتحه
حزمة الإضافةإصدار godot-mcp أو ملف ZIP المصدر من GitHub
IDE ذكييُنصح بـ Cursor؛ عملاء MCP الآخرون يعملون أيضًا
الشبكة المحليةعادةً ما يعمل جسر MCP على 127.0.0.1—لا تعرض المنفذ للعامة

الخطوة 1: تنزيل Godot MCP

نزّل Godot MCP مفتوح المصدر من GitHub:

المستودع: https://github.com/DaxianLee/godot-mcp

الطريقة المقترحة:

  1. افتح المستودع واستخدم Code ← Download ZIP، أو احصل على أحدث حزمة من Releases
  2. احفظ الأرشيف محليًا واستعد لاستخراجه
  3. تأكد من أن الحزمة تبدو كإضافة Godot (مجلد متعلق بـ addons، أو مجلد إضافة يمكنك وضعه في addons)

الخطوة 2: إضافة Godot MCP إلى مشروعك

  1. استخرج الأرشيف على جهازك
  2. انقل مجلد الإضافة المستخرج إلى مجلد addons في جذر مشروع Godot
    • إذا لم يكن addons موجودًا بعد، فأنشئه أولاً
  3. افتح (أو أعد تحميل) المشروع في Godot وتأكد من ظهور ملفات الإضافة في لوحة FileSystem

مثال على تخطيط المشروع بعد الاستيراد:

ضع مجلد إضافة Godot MCP تحت مجلد addons الخاص بالمشروع

الخطوة 3: تفعيل إضافة Godot MCP في Project Settings

  1. افتح Project ← Project Settings (أو ما يعادله لإصدار Godot لديك)
  2. انتقل إلى علامة التبويب Plugins
  3. ابحث عن Godot MCP Server (قد يختلف الاسم قليلاً في الواجهة)
  4. فعّلها

بعد التفعيل، يجب أن يظهر إدخال Godot MCP في لوحة جانبية أو لوحة إرساء بحيث يمكنك ضبط المنفذ وتشغيل الخادم في الخطوة التالية.

فعّل Godot MCP Server في Project Settings ← Plugins

الخطوة 4: تشغيل خادم Godot MCP

  1. في اللوحة اليمنى لمحرر Godot، افتح لوحة GodotMCP
  2. راجع واضبط حسب الحاجة:
    • المنفذ: الافتراضي 3000
    • اللغة: اختر ما يناسب تفضيل واجهتك
    • بدء التشغيل: يمكنك تفعيل البدء التلقائي بحيث يعمل الخادم عند فتح المشروع
  3. انقر Start
  4. عندما تظهر اللوحة Running (أو ما يعادلها باللغة المحلية)، يكون Godot MCP Server قد بدأ

لديك الآن جسر MCP محلي. بعد ذلك، سلّمه إلى IDE الذكي الخاص بك.

اضبط المنفذ في لوحة GodotMCP وابدأ حتى تظهر Running

الخطوة 5: إعداد IDE الذكي بنقرة واحدة (مثال Cursor)

  1. في لوحة GodotMCP، افتح Tools
    • راجع الأدوات التي يوفرها الخادم
    • فعّل فقط الإمكانات التي تريد أن يستخدمها الذكاء الاصطناعي
  2. افتح Configure
    • اختر IDE الخاص بك (على سبيل المثال Cursor)
    • انقر One-click configure
    • انتظر رسالة configuration successful
  3. افتح Cursor
    • في قائمة MCP / الأدوات يجب أن ترى godot-mcp متصلًا تلقائيًا
    • إذا لم يظهر، انقر Reload (أو إجراء إعادة تحميل MCP المكافئ) في Cursor وتحقق مرة أخرى

التهيئة والاتصال:

قم بتهيئة Cursor بنقرة واحدة من GodotMCP وتأكد من اتصال godot-mcp

تحقق سريع بعد الاتصال

في Cursor، ابدأ بفحص للقراءة فقط، على سبيل المثال:

اذكر العقد الجذرية للمشهد النشط في Godot.

إذا كان الرد مطابقًا للتسلسل الهرمي في المحرر، فإن الجسر يعمل. ثم جرّب كتابة صغيرة (أنشئ عقدة مؤقتة واحذفها) لتأكيد الأذونات واختيار الأدوات.

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

نسخت الملفات إلى addons، لكن Godot MCP Server مفقود من قائمة الإضافات؟
تأكد من أن المجلد موجود في addons/<اسم-الإضافة>/ وليس متداخلًا بمستوى إضافي من فك الضغط. أعد تحميل المشروع أو أعد تشغيل Godot.

نقرت Start لكن لا تظهر Running أبدًا؟
تأكد من أن المنفذ 3000 (أو منفذك المخصص) غير مشغول، ثم أعد المحاولة. تحقق من عدم وجود ما يحظر localhost.

Cursor لا يعرض godot-mcp؟
في Godot، تأكد من أن الخادم ما زال يعمل، وأعد تشغيل التهيئة بنقرة واحدة، ثم أعد تحميل MCP في Cursor. إذا استمرت المشكلة، تحقق من أن إعداد MCP في Cursor يتضمن عنوان الجسر المحلي.

البدء التلقائي مفعّل، لكن ما زلت بحاجة إلى البدء يدويًا؟
بعض الإصدارات تتطلب بدءًا يدويًا ناجحًا واحدًا أولاً. تأكد من حفظ خانة الاختيار، ثم أعد فتح نفس المشروع وتحقق.

الخطوات التالية

  • استخدم اللغة الطبيعية لاستعلام عن مشهد أو تعديل صغير لتعلم حدود الأدوات
  • احفظ التغييرات قبل التعديلات الكبيرة؛ أبقِ الجسر على localhost فقط
  • لتسليم واجهة التصميم إلى المحرك، يمكنك الاقتران مع VberAI Studio، ثم كرر العمل في المحرر باستخدام MCP

لمزيد من الخلفية حول Godot + MCP، راجع كيف بنينا خادم MCP في الوقت الفعلي لـ Godot.

تابع القراءة

أدلة أخرى قد تعجبك