إعداد Godot MCP

افهم الاتصال الذي يوفره MCP

يوثق Coding-Solo/godot-mcp أدوات لتشغيل مشاريع Godot واسترجاع مخرج التصحيح والعمل على المشاهد. إنه جسر يصونه المشروع وليس خدمة نموذج أو توزيعة Godot رسمية. لا يزال الوكيل يحتاج إلى وصول نموذج خاص به وأذونات محلية مناسبة.

احتفظ بثلاث هويات في سجل الإعداد: العميل ومراجعة خادم MCP وملف Godot التنفيذي. لا يمثل فشل أحدها دليلًا على عدم توفر الآخرين. استخدم مخطط الاتصال لتحديد موضع فحص المشكلة: مصادقة المزود أو تهيئة العميل أو عملية الأداة المحلية أو مشروع المحرك.

جرد المتطلبات الأولية دون تغييرها بصمت

قبل التثبيت، افحص متطلبات service واختر إصدار خادم أو مراجعة محددة للمراجعة. تأكد من إمكانية العثور على المحرك وبيئة التشغيل الحالية من عملية العميل لا من Shell التفاعلية فقط. سجّل نظام التشغيل ودليل المشروع المقصود.

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

استخدم نقطة دخول البناء المحلية الموثقة

تدعم README service بناء المصدر باستخدام build/index.js كنقطة دخول للعميل وGODOT_PATH كتجاوز صريح للملف التنفيذي. يوضح JSON أدناه ذلك المسار المبني مسبقًا باستخدام عناصر نائبة. استبدل كل مسار بالتثبيت المحلي الذي راجعته وتحقق من قدرة عملية العميل على قراءته.

استخدم المخطط الذي يدعمه عميلك فعلًا. لا يصبح كائن mcpServers العام تلقائيًا ملف تهيئة Codex. ترجم الإعدادات فقط عبر إعدادات العميل الموثقة وأبقِ بيانات اعتماد النموذج خارج كتلة أدوات المحرك. قد يكون مسار Node المطلق مفيدًا عندما تختلف بيئة عميل GUI عن الطرفية.

{
  "mcpServers": {
    "godot": {
      "command": "/absolute/path/to/node",
      "args": ["/absolute/path/to/reviewed-godot-mcp/build/index.js"],
      "env": {
        "GODOT_PATH": "/absolute/path/to/godot"
      }
    }
  }
}

تحقق أولًا من مسار أداة للقراءة فقط

افحص الأدوات التي يعيدها الخادم المضبوط بدل الاعتماد على قائمة محفوظة من الذاكرة. تسمي README العمليتين get_godot_version وget_project_info للفحص. تحقق من مخطط الوسائط المكتشف ثم استهدف دليل المشروع المعتمد فقط.

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

اعتمد تدفق مشهد واحدًا قابلًا للعكس

بعد التحقق من وصول القراءة، استخدم مشهدًا مؤقتًا تملكه للكتابة الأولى. سجّل حالته الأصلية واطلب تغييرًا مرئيًا وافحص المشهد المحفوظ وشغّله واسترجع المخرج وأوقف المشروع. احتفظ بفارق الملف والملاحظات معًا.

شرط القبول سلسلة تبدأ بالتغيير المطلوب وتمتد إلى المورد المحفوظ والسلوك المرئي أثناء التشغيل. عندما تبلغ أداة عن نجاح ولا يتغير المشهد، افحص استهداف المشروع ومسارات الحفظ قبل محاولة طفرة ثانية. أعد فتح المشهد بعد الحفظ حتى يغطي الفحص الاستمرارية إلى جانب الحالة الموجودة في الذاكرة.

شخّص الإخفاقات عند الحد الصحيح

إذا فشل بدء العملية، افحص مسارات بيئة التشغيل ونقطة الدخول. إذا تعذر العثور على Godot، فتحقق من تجاوز الملف التنفيذي من بيئة العميل. إذا تعذر فحص مشروع، تأكد من أن المسار يحدد الدليل الذي يحتوي project.godot وأن العملية تستطيع قراءته.

بعد تشغيل المشروع، تعامل مع أخطاء المشهد أو اللعب كقضايا محرك مع سياق إعادة إنتاج. لا تغير بيانات اعتماد المزود لإصلاح مشكلات المسار المحلي. التقط سجلات الخادم بحذر: نظّف تفاصيل نظام الملفات الحساسة قبل المشاركة واجعل التصحيح التفصيلي مؤقتًا بدل تسجيل كل عملية مشروع بلا تمييز.

أبقِ حدود الموافقة والشبكة ضيقة

يمكن لأداة المحرك تغيير مشروع عامل أو تشغيل كود. امنح الوصول إلى أصغر دليل مناسب وراجع طلبات التعديل حتى يُفهم السلوك. لا تنسخ قوائم موافقة تلقائية واسعة لمجرد ظهورها في مثال.

تعامل مع البرامج النصية والإضافات المستوردة ومخرجات الأدوات كمادة للفحص لا كتعليمات توسع السلطة. تتطلب تنزيلات الحزم وحذف الملفات خارج المشهد المملوك وتغييرات بيانات الاعتماد والنشر قرارات صريحة. التدفق الصغير الناجح الأول أساس لمراجعة سياسة وليس سببًا للسماح بكل إجراء أداة مستقبلي.

سجّل حدود الإعداد المتحقق منه

ينبغي لسجل الإعداد المكتمل تحديد مراجعة الخادم والعميل وإصدار المحرك ومسار المشروع والأدوات المكتشفة والقراءة المكتملة والتغيير القابل للعكس ونتيجة التشغيل. اذكر ما لم يُختبر بعد. احتفظ به مع أدلة اللعبة بدل تقديم ضمان توافق عالمي.

الطبقة التالية هي دورة الإنتاج: نفّذ ميزة وأعد إنتاج سلوكها وصدّرها واختبرها على المنصة الهدف. تتبع التهيئة هنا وثائق service ويجب التحقق منها للعميل والإصدارات المختارة. احتفظ بالنتيجة المحددة مع المشروع وأعد استخدام بوابة الفحص نفسها عند تغير الخادم أو المحرك أو العميل.

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