इस प्रोजेक्ट के बारे में

Unreal Engine MCP Server एक Model Context Protocol सर्वर है जो AI सहायकों को नेटिव C++ ऑटोमेशन ब्रिज प्लगइन के माध्यम से Unreal Engine 5 को संचालित करने देता है। यह TypeScript और C++ में लिखा गया है, npm पर unreal-engine-mcp-server के रूप में प्रकाशित है, और MIT लाइसेंस के अंतर्गत है। क्षमताएँ क्षेत्र के अनुसार समूहीकृत हैं: एसेट प्रबंधन (ब्राउज़, आयात, डुप्लिकेट, नाम बदलें, हटाएं, मटेरियल बनाएं), एक्टर नियंत्रण (स्पॉन, हटाएं, ट्रांसफॉर्म, फिजिक्स, टैग, कंपोनेंट्स), एडिटर नियंत्रण (PIE सत्र, कैमरा, व्यूपोर्ट, स्क्रीनशॉट, बुकमार्क), लेवल प्रबंधन (लोड/सेव, स्ट्रीमिंग, लाइटिंग), एनीमेशन और फिजिक्स (एनीमेशन ब्लूप्रिंट, स्टेट मशीन, रैगडॉल, वाहन, कंस्ट्रेंट्स), विज़ुअल इफेक्ट्स (Niagara पार्टिकल्स, GPU सिमुलेशन, डीबग शेप्स), Sequencer (सिनेमैटिक्स, टाइमलाइन नियंत्रण, Movie Render Queue, मीडिया, Take Recorder, रीप्ले), ग्राफ एडिटिंग (Blueprint, Niagara, Material, Behavior Tree), ऑडियो (साउंड क्यू, कंपोनेंट्स, मिक्स, एम्बिएंट साउंड्स) और सिस्टम ऑपरेशन (कंसोल कमांड, UBT, टेस्ट, लॉग्स, प्रोजेक्ट सेटिंग्स, CVars)। दो ट्रांसपोर्ट प्रदान किए जाते हैं। नेटिव MCP ट्रांसपोर्ट प्लगइन में एक अंतर्निहित Streamable HTTP/SSE सर्वर है, जो http://localhost:3000/mcp पर उपलब्ध है, और इसे Node.js, npm या ब्रिज की आवश्यकता नहीं है। TypeScript ब्रिज एक stdio सर्वर है जो WebSocket के माध्यम से प्लगइन से बात करता है। दोनों एक ही unreal गेटवे टूल को चार ऑपरेशनों के साथ उजागर करते हैं: search, describe, execute और configure। 23 कैनोनिकल पैरेंट टूल आंतरिक हैं और केवल गेटवे के माध्यम से पहुंचे जाते हैं; कैनोनिकल नामों पर सीधे कॉल एक माइग्रेशन रसीद लौटाते हैं जिसमें सुझाया गया अगला कॉल होता है। प्रोटोकॉल संस्करण वार्ता दोनों सतहों के बीच भिन्न होती है, नेटिव ट्रांसपोर्ट केवल नए संस्करणों का समर्थन करता है। सेटअप के लिए TypeScript ब्रिज के लिए Node.js 20.19 या बाद का संस्करण आवश्यक है, साथ ही McpAutomationBridge प्लगइन को प्रोजेक्ट के Plugins फ़ोल्डर में कॉपी करके, बाहरी प्लगइन निर्देशिका जोड़कर, या किसी विशिष्ट इंजन संस्करण से बंधे प्री-बिल्ट बाइनरी का उपयोग करके स्थापित किया जाना चाहिए। स्रोत इंस्टॉल के लिए कोड टारगेट की आवश्यकता होती है; केवल 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, टाइमआउट, लॉग स्तर और अतिरिक्त कंटेंट पथ उपसर्ग का उपयोग करता है। LAN एक्सेस डिफ़ॉल्ट रूप से बंद है और इसे स्पष्ट रूप से सक्षम किया जाना चाहिए, सुरक्षा चेतावनी के साथ। क्षमता टोकन प्रमाणीकरण डिफ़ॉल्ट रूप से चालू है, जो स्वतः-जनित गुप्त फ़ाइल या मैन्युअल रूप से कॉन्फ़िगर किए गए टोकन का उपयोग करता है। अन्य नोट किए गए व्यवहारों में डायनामिक टाइप डिस्कवरी, सक्रिय Unreal कनेक्शन के बिना सुचारू स्टार्टअप, एक्सपोनेंशियल बैकऑफ़ के साथ हैंडशेक पुनः प्रयास, खतरनाक कंसोल कमांड को ब्लॉक करना, 10-सेकंड एसेट कैश, और Prometheus मेट्रिक्स एंडपॉइंट पर प्रति-IP दर सीमा शामिल है। एक Dockerfile शामिल है, और रिपॉजिटरी बिल्ड, लिंट, टाइप-चेक, यूनिट टेस्ट, स्मोक टेस्ट, मैनिफेस्ट ड्रिफ्ट चेक, नेटिव पैरिटी टेस्ट, पैरामीटर ऑडिट और संस्करण जांच के लिए डेवलपमेंट स्क्रिप्ट दस्तावेज़ित करता है, साथ ही CI गेट्स और गेटवे मैनिफेस्ट जनरेशन स्क्रिप्ट भी। दस्तावेज़ीकरण में एक्शन संदर्भ, प्लगइन एक्सटेंशन आर्किटेक्चर, परीक्षण और रोडमैप शामिल हैं।