منصوبے کے بارے میں

Unreal Engine MCP Server ایک Model Context Protocol سرور ہے جو AI معاونین کو نیٹو C++ Automation Bridge پلگ ان کے ذریعے Unreal Engine 5 چلانے دیتا ہے۔ یہ TypeScript اور C++ میں لکھا گیا ہے، npm پر unreal-engine-mcp-server کے نام سے شائع ہوا ہے، اور MIT لائسنس کے تحت ہے۔ صلاحیتیں علاقے کے لحاظ سے گروپ کی گئی ہیں: اثاثہ جات کا انتظام (براؤز، درآمد، نقل، نام تبدیل، حذف، میٹریل بنانا)، اداکار کنٹرول (spawn، حذف، transform، فزکس، ٹیگز، اجزاء)، ایڈیٹر کنٹرول (PIE سیشنز، کیمرہ، viewport، اسکرین شاٹس، بک مارکس)، لیول کا انتظام (لوڈ/محفوظ، اسٹریمنگ، لائٹنگ)، اینیمیشن اور فزکس (اینیمیشن بلیو پرنٹس، اسٹیٹ مشینیں، ragdolls، گاڑیاں، constraints)، بصری اثرات (Niagara ذرات، GPU سمولیشنز، ڈیبگ شکلیں)، Sequencer (cinematics، ٹائم لائن کنٹرول، Movie Render Queue، میڈیا، Take Recorder، replay)، گراف ایڈیٹنگ (Blueprint، Niagara، Material، Behavior Tree)، آڈیو (ساؤنڈ cues، اجزاء، mixes، ambient sounds) اور سسٹم آپریشنز (کنسول کمانڈز، UBT، ٹیسٹ، لاگز، پروجیکٹ سیٹنگز، CVars)۔ دو transports پیش کیے گئے ہیں۔ نیٹو MCP transport پلگ ان میں ایک بلٹ ان Streamable HTTP/SSE سرور ہے، جو http://localhost:3000/mcp پر قابل رسائی ہے، جس کے لیے Node.js، npm یا برج کی ضرورت نہیں۔ TypeScript برج ایک stdio سرور ہے جو WebSocket کے ذریعے پلگ ان سے بات کرتا ہے۔ دونوں ایک ہی واحد unreal گیٹ وے ٹول کو چار آپریشنز کے ساتھ ظاہر کرتے ہیں: search، describe، execute اور configure۔ 23 کینونیکل پیرنٹ ٹولز اندرونی ہیں اور صرف گیٹ وے کے ذریعے قابل رسائی ہیں؛ کینونیکل ناموں پر براہ راست کالز ایک migration receipt واپس کرتی ہیں جس میں تجویز کردہ اگلی کال ہوتی ہے۔ پروٹوکول ورژن کی گفت و شنید دونوں سطحوں کے درمیان مختلف ہے، نیٹو transport صرف نئے ورژنز کی حمایت کرتا ہے۔ سیٹ اپ کے لیے TypeScript برج کے لیے Node.js 20.19 یا بعد کا ورژن درکار ہے، نیز McpAutomationBridge پلگ ان جو یا تو پروجیکٹ کے Plugins فولڈر میں کاپی کر کے، بیرونی پلگ ان ڈائریکٹری شامل کر کے، یا کسی مخصوص انجن ورژن سے منسلک پہلے سے بنے binaries استعمال کر کے انسٹال کیا جاتا ہے۔ سورس انسٹالز کے لیے code target درکار ہے؛ صرف Blueprint والے پروجیکٹس کو پہلے ایک C++ کلاس شامل کرنی ہوگی۔ کئی بنیادی پلگ انز درکار ہیں (Python Editor Script Plugin، Editor Scripting Utilities، Niagara، Gameplay Abilities، Smart Objects) اور بہت سے اختیاری پلگ انز ضرورت پڑنے پر خودکار طور پر فعال ہو جاتے ہیں۔ انجن ورژنز 5.0 سے 5.8 تک معاون بتائے گئے ہیں۔ کنفیگریشن ماحول متغیرات استعمال کرتی ہے جیسے UE_PROJECT_PATH، MCP_AUTOMATION_HOST، MCP_AUTOMATION_PORT، timeouts، log level اور اضافی content path prefixes۔ LAN رسائی بطور ڈیفالٹ بند ہے اور اسے واضح طور پر فعال کرنا ہوگا، ایک سیکیورٹی انتباہ کے ساتھ۔ Capability token authentication بطور ڈیفالٹ آن ہے، جو خودکار طور پر بنائی گئی secret فائل یا دستی طور پر کنفیگر شدہ token استعمال کرتی ہے۔ دیگر قابل ذکر رویوں میں dynamic type discovery، فعال Unreal کنکشن کے بغیر graceful startup، exponential backoff کے ساتھ handshakes کی دوبارہ کوشش، خطرناک کنسول کمانڈز کی بلاکنگ، 10 سیکنڈ کا asset cache، اور Prometheus metrics endpoint پر فی IP rate limiting شامل ہیں۔ ایک Dockerfile شامل ہے، اور repository میں build، lint، type-check، unit tests، smoke tests، manifest drift checks، native parity tests، parameter audits اور version checks کے لیے development scripts دستاویزی ہیں، ساتھ ہی CI gates اور ایک gateway manifest generation script بھی۔ دستاویزات میں action reference، plugin extension architecture، testing اور ایک roadmap شامل ہے۔