عن المشروع

خادم Godot MCP هو خادم بروتوكول سياق النموذج (MCP) الذي يربط وكلاء الذكاء الاصطناعي بمحرك ألعاب Godot. يتيح للمساعدين الذكيين التفاعل مباشرة مع مشاريع Godot عن طريق تشغيل المحرر، وتشغيل المشاريع في وضع التصحيح، والتقاط مخرجات وحدة التحكم، والتحكم في تدفق التنفيذ. يوفر الخادم أيضًا إمكانيات إدارة المشاهد، بما في ذلك إنشاء المشاهد، وإضافة العقد بخصائص مخصصة، وتحميل الصور، وتصدير المشاهد ثلاثية الأبعاد كموارد مكتبة الشبكات، وإدارة مراجع UID لإصدار Godot 4.4+. ## الميزات الرئيسية - **التحكم في المحرر والمشروع**: تشغيل محرر Godot، وتشغيل المشاريع في وضع التصحيح، وإيقافها برمجيًا - **التقاط مخرجات التصحيح**: استرجاع مخرجات وحدة التحكم ورسائل الأخطاء للتغذية الراجعة في الوقت الفعلي - **تحليل المشروع**: سرد المشاريع في دليل، والحصول على معلومات هيكل المشروع التفصيلية، واسترجاع إصدار Godot المثبت - **إدارة المشاهد**: - إنشاء مشاهد جديدة بأنواع عقد جذر محددة - إضافة عقد إلى المشاهد الموجودة بخصائص قابلة للتخصيص - تحميل الصور/الأنسجة إلى عقد Sprite2D - تصدير المشاهد ثلاثية الأبعاد كموارد مكتبة الشبكات لـ GridMap - حفظ المشاهد بخيارات متغيرة - **إدارة UID** (Godot 4.4+): الحصول على UIDs للملفات وتحديث مراجع UID عن طريق إعادة حفظ الموارد ## البنية يستخدم الخادم نهجًا هجينًا: 1. **الأوامر المباشرة**: العمليات البسيطة (تشغيل المحرر، الحصول على الإصدار) تستخدم أوامر سطر الأوامر المدمجة في Godot 2. **سكريبت العمليات المدمج**: العمليات المعقدة (إنشاء المشاهد، معالجة العقد) تستخدم ملف GDScript شامل واحد (`godot_operations.gd`) يقبل نوع العملية والمعلمات كـ JSON، مما يتيح تنفيذًا مرنًا دون إنشاء ملفات مؤقتة ## المتطلبات - محرك Godot مثبت - Node.js (>=18.0.0) و npm - وكيل ذكاء اصطناعي متوافق مع MCP (مثل Claude Code، Cursor) ## البدء السريع لـ Claude Code: ```bash claude mcp add godot -- npx @coding-solo/godot-mcp ``` لـ Cursor، أضف خادم MCP في الإعدادات بالأمر `npx @coding-solo/godot-mcp`. ## التكوين متغيرات البيئة: - `GODOT_PATH`: مسار ملف Godot القابل للتنفيذ (يتجاوز الاكتشاف التلقائي) - `DEBUG`: اضبط على `"true"` لتسجيل مفصّل على جانب الخادم ## استكشاف الأخطاء وإصلاحها - **Godot غير موجود**: اضبط متغير البيئة `GODOT_PATH` - **مشاكل الاتصال**: تأكد من تشغيل الخادم وأعد تشغيل مساعد الذكاء الاصطناعي - **مسار مشروع غير صالح**: تأكد من أن المسار يحتوي على ملف `project.godot` - **مشاكل البناء**: قم بتشغيل `npm install` لتثبيت التبعيات ## الترخيص رخصة MIT