خادم MCP للتفاعل مع محرك الألعاب Godot. يوفر أدوات لبدء المحرر وتشغيل المشاريع والتقاط مخرجات التصحيح.

أولاً: نظرة عامة على المشروع

Godot MCP (خادم بروتوكول سياق النموذج - Model Context Protocol Server) هو أداة تم إصدارها بواسطة Coding-Solo، وهي بمثابة جسر بين مساعدي الذكاء الاصطناعي ومحرك Godot. من خلال بروتوكول MCP، يمكنه تشغيل محرر Godot، وتشغيل المشاريع، والتقاط معلومات التصحيح، والتحكم العميق في هيكل المشروع والمشاهد.

توفر هذه الآلية حلقة ملاحظات حقيقية لمساعدي الذكاء الاصطناعي (مثل Claude و Cline و Cursor)، مما يمكنهم من تشغيل المشاريع فعليًا، وتصحيح المشكلات، وإنشاء كود GDScript عالي الجودة.

---

ثانياً: الوظائف والميزات الأساسية

1. تشغيل المحرر وتشغيل المشاريع يدعم عبر سطر الأوامر:

   • تشغيل محرر Godot في مسار محدد
   • تشغيل المشروع في وضع التصحيح
   • التقاط وإرجاع مخرجات وحدة التحكم أو معلومات الخطأ

2. الحصول على هيكل المشروع وتحليله

   • الحصول على إصدار المشروع وهيكل الدليل وقائمة الموارد
   • معلومات متعمقة حول هيكل المشهد، بما في ذلك شجرة العقد والخصائص ومسارات الموارد، إلخ.

3. إدارة المشاهد والعقد

   • إنشاء مشاهد جديدة (تحديد نوع العقدة الجذرية)
   • إضافة عقد إلى المشاهد الحالية وتعيين الخصائص
   • تحميل نسيج Sprite2D، وتصدير MeshLibrary لاستخدامه في GridMap
   • حفظ المشاهد ودعم إنشاء متغيرات المشهد

4. التصحيح وإدارة الإصدار

   • إيقاف المشروع قيد التشغيل
   • الحصول على وعرض إصدار محرك Godot
   • (ينطبق على Godot 4.4+) الحصول على UID للملف وتحديث مراجع الموارد

5. التوافق مع العديد من أدوات المساعدة بالذكاء الاصطناعي

   • يدعم Cline و Cursor: من خلال ملفات إعدادات MCP، وتكامل سطر الأوامر مع أدوات المساعدة بالذكاء الاصطناعي

---

ثالثاً: أبرز ميزات الهندسة المعمارية والتنفيذ

• "نص برمجي للعمليات" GDScript واحد تتم إدارة جميع الأوامر المعقدة (مثل إنشاء العقد، وتصدير المشهد، وما إلى ذلك) بواسطة ملف واحد godot_operations.gd، مما يتجنب إنشاء نصوص برمجية مؤقتة بشكل فردي، ويضمن البساطة والكفاءة، ويقلل من إدخال/إخراج القرص واحتمالية حدوث أخطاء.

• آلية الجمع بين CLI والنص البرمجي يتم تنفيذ الأوامر البسيطة مباشرةً من خلال Godot CLI، بينما يتم تنفيذ العمليات المعقدة من خلال نصوص GDScript، وكلاهما ينقل تعليمات JSON القياسية لـ MCP، بهيكل موحد وسهل التوسع.

• هيكل استجابة موحد ترجع جميع العمليات تنسيقًا موحدًا: الحالة ومحتوى النتيجة والمخرجات/الأخطاء القياسية، مما يسهل على الذكاء الاصطناعي التحليل والتعلم وإنشاء اقتراحات تغيير تلقائية.

---

رابعاً: سير العمل

1. التثبيت والبناء

   git clone https://github.com/Coding-Solo/godot-mcp.git
   cd godot-mcp
   npm install
   npm run build
   

2. تكوين أدوات الذكاء الاصطناعي

   • Cline: أضف تكوين الخادم المقابل في cline_mcp_settings.json
   • Cursor: أضف أمر node من خلال Settings → Features → MCP

3. التشغيل والتفاعل

   • أمثلة على أوامر الذكاء الاصطناعي:

     • launch_editor: تشغيل المحرر
     • run_project: تنفيذ المشروع والحصول على المخرجات
     • create_scene / add_node: إنشاء مشهد/عقدة
     • get_debug_output / stop_project: أوامر التحكم في التصحيح
     • get_uid / update_project_uids: إدارة UID

---

خامساً: ملخص لأبرز ميزات المشروع

| الميزة | الوصف