عن المشروع

## نظرة عامة MCP for Unity هو جسر مفتوح المصدر يربط مساعدي الذكاء الاصطناعي (Claude، Codex، VS Code، نماذج اللغة المحلية، وأي عميل متوافق مع MCP) بمحرر Unity باستخدام بروتوكول Model Context Protocol. يتيح للمطورين التحكم في Unity من خلال اللغة الطبيعية—إنشاء المشاهد وكائنات اللعبة، تحرير البرامج النصية C#، إدارة الأصول، تشغيل الاختبارات، التنميط، وبناء المشاريع. المشروع مجاني بموجب ترخيص MIT ويتم صيانته بواسطة Aura، مع أداة متميزة مصاحبة تسمى Aura for Unity. ## الميزات الرئيسية - **47 نقطة دخول لأدوات MCP** تغطي إنشاء المشاهد، إدارة الأصول، تحرير البرامج النصية، الاختبار، التنميط، وأتمتة البناء. - **دعم أي عميل MCP** بما في ذلك Claude Desktop/Code، Cursor، VS Code، Windsurf، Cline، وGemini CLI. - **توافق إصدارات Unity** من 2021.3 LTS حتى 6.x. - **توجيه متعدد الحالات** للعمل مع عدة محررات Unity في وقت واحد. - **مجموعات أدوات** (vfx، animation، ui، testing، إلخ) لسير عمل منظم. - **تحقق من البرامج النصية عبر Roslyn** لالتقاط الأخطاء قبل التنفيذ. - **دعم خادم بعيد** مع مصادقة للنشر المستضاف. ## بدء سريع 1. التثبيت عبر Unity Package Manager باستخدام رابط git: `https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main` (أو تثبيت علامة إصدار مثل `#v10.0.0`). 2. تكوين العملاء عبر `Window → MCP for Unity → Configure All Detected Clients`. 3. ابدأ بالأوامر، على سبيل المثال: "أنشئ مكعبًا عند نقطة الأصل وأضف Rigidbody." ## المتطلبات - Unity 2021.3 LTS أو أحدث (حتى 6.x) - Python 3.10+ (يُدار عبر `uv`) - أي عميل ذكاء اصطناعي متوافق مع MCP ## الاستخدام المتقدم - **توجيه متعدد الحالات**: توجيه الأوامر إلى حالات Unity محددة. - **مجموعات الأدوات**: تمكين/تعطيل فئات الأدوات لسير عمل مركّز. - **ترحيل v10**: ملاحظات الترقية لتغييرات توليد الأصول. - **تحقق Roslyn**: تحقق من برامج C# النصية من جانب الخادم. - **مصادقة الخادم البعيد**: استضافة آمنة عن بُعد مع مصادقة. ## المجتمع والدعم - Discord للدردشة مع الصيانين والمساهمين - GitHub Issues للأخطاء وطلبات الميزات - GitHub Discussions للأفكار التصميمية - SECURITY.md للإبلاغ الخاص عن الثغرات ## الاستشهاد إذا استُخدم في البحث، استشهد بـ: Wu, Shutong and Barnett, Justin P. "MCP-Unity: Protocol-Driven Framework for Interactive 3D Authoring." SA Technical Communications '25. DOI: 10.1145/3757376.3771417. ## الترخيص MIT — مجاني للاستخدام التجاري والشخصي. غير تابع لشركة Unity Technologies.