প্রকল্প সম্পর্কে

আনরিয়েল ইঞ্জিন MCP সার্ভার একটি মডেল কনটেক্সট প্রোটোকল সার্ভার যা AI সহায়কদের নেটিভ C++ অটোমেশন ব্রিজ প্লাগইনের মাধ্যমে আনরিয়েল ইঞ্জিন ৫ পরিচালনা করতে দেয়। এটি TypeScript এবং C++-এ লেখা, npm-এ unreal-engine-mcp-server হিসেবে প্রকাশিত, এবং MIT লাইসেন্সের অধীনে। ক্ষমতাগুলি এলাকা অনুযায়ী গ্রুপ করা হয়েছে: সম্পদ ব্যবস্থাপনা (ব্রাউজ, ইমপোর্ট, ডুপ্লিকেট, রিনেম, ডিলিট, ম্যাটেরিয়াল তৈরি), অ্যাক্টর নিয়ন্ত্রণ (স্পন, ডিলিট, ট্রান্সফর্ম, ফিজিক্স, ট্যাগ, কম্পোনেন্ট), এডিটর নিয়ন্ত্রণ (PIE সেশন, ক্যামেরা, ভিউপোর্ট, স্ক্রিনশট, বুকমার্ক), লেভেল ব্যবস্থাপনা (লোড/সেভ, স্ট্রিমিং, লাইটিং), অ্যানিমেশন এবং ফিজিক্স (অ্যানিমেশন ব্লুপ্রিন্ট, স্টেট মেশিন, র্যাগডল, যানবাহন, কনস্ট্রেইন্ট), ভিজ্যুয়াল ইফেক্ট (নায়াগ্রা পার্টিকেল, GPU সিমুলেশন, ডিবাগ শেপ), সিকোয়েন্সার (সিনেমেটিক্স, টাইমলাইন নিয়ন্ত্রণ, মুভি রেন্ডার কিউ, মিডিয়া, টেক রেকর্ডার, রিপ্লে), গ্রাফ এডিটিং (ব্লুপ্রিন্ট, নায়াগ্রা, ম্যাটেরিয়াল, বিহেভিয়ার ট্রি), অডিও (সাউন্ড কিউ, কম্পোনেন্ট, মিক্স, অ্যাম্বিয়েন্ট সাউন্ড) এবং সিস্টেম অপারেশন (কনসোল কমান্ড, UBT, টেস্ট, লগ, প্রজেক্ট সেটিংস, CVars)। দুটি ট্রান্সপোর্ট দেওয়া হয়। নেটিভ MCP ট্রান্সপোর্ট হল প্লাগইনের মধ্যে একটি অন্তর্নির্মিত Streamable HTTP/SSE সার্ভার, যা http://localhost:3000/mcp-এ অ্যাক্সেসযোগ্য, এবং এতে Node.js, npm বা ব্রিজের প্রয়োজন নেই। TypeScript ব্রিজ হল একটি stdio সার্ভার যা WebSocket-এর মাধ্যমে প্লাগইনের সাথে কথা বলে। উভয়ই একই একক unreal গেটওয়ে টুল প্রকাশ করে যার চারটি অপারেশন রয়েছে: search, describe, execute এবং configure। ২৩টি ক্যানোনিকাল প্যারেন্ট টুল অভ্যন্তরীণ এবং শুধুমাত্র গেটওয়ের মাধ্যমে পৌঁছানো যায়; ক্যানোনিকাল নামে সরাসরি কল একটি মাইগ্রেশন রিসিট ফেরত দেয় যার সাথে একটি প্রস্তাবিত পরবর্তী কল থাকে। প্রোটোকল সংস্করণ আলোচনা দুটি পৃষ্ঠের মধ্যে ভিন্ন, নেটিভ ট্রান্সপোর্ট শুধুমাত্র নতুন সংস্করণ সমর্থন করে। সেটআপের জন্য TypeScript ব্রিজের জন্য Node.js 20.19 বা তার পরে প্রয়োজন, সাথে McpAutomationBridge প্লাগইন ইনস্টল করতে হবে হয় প্রজেক্টের Plugins ফোল্ডারে কপি করে, একটি বাহ্যিক প্লাগইন ডিরেক্টরি যোগ করে, অথবা নির্দিষ্ট ইঞ্জিন সংস্করণের সাথে যুক্ত প্রি-বিল্ট বাইনারি ব্যবহার করে। সোর্স ইনস্টলের জন্য একটি কোড টার্গেট প্রয়োজন; শুধুমাত্র ব্লুপ্রিন্ট প্রজেক্টে প্রথমে একটি 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 অ্যাক্সেস ডিফল্টভাবে বন্ধ এবং স্পষ্টভাবে সক্রিয় করতে হবে, একটি নিরাপত্তা সতর্কতা সহ। ক্যাপাবিলিটি টোকেন প্রমাণীকরণ ডিফল্টভাবে চালু, একটি স্বয়ংক্রিয়-জেনারেটেড সিক্রেট ফাইল বা ম্যানুয়ালি কনফিগার করা টোকেন ব্যবহার করে। অন্যান্য উল্লেখযোগ্য আচরণের মধ্যে রয়েছে ডায়নামিক টাইপ আবিষ্কার, সক্রিয় আনরিয়েল সংযোগ ছাড়া মসৃণ স্টার্টআপ, এক্সপোনেনশিয়াল ব্যাকঅফ সহ হ্যান্ডশেক পুনরায় চেষ্টা, বিপজ্জনক কনসোল কমান্ড ব্লক করা, ১০-সেকেন্ডের সম্পদ ক্যাশ, এবং Prometheus মেট্রিক্স এন্ডপয়েন্টে প্রতি-IP রেট লিমিটিং। একটি Dockerfile অন্তর্ভুক্ত রয়েছে, এবং রিপোজিটরিটি বিল্ড, লিন্ট, টাইপ-চেক, ইউনিট টেস্ট, স্মোক টেস্ট, ম্যানিফেস্ট ড্রিফট চেক, নেটিভ প্যারিটি টেস্ট, প্যারামিটার অডিট এবং সংস্করণ চেকের জন্য ডেভেলপমেন্ট স্ক্রিপ্ট নথিভুক্ত করে, সাথে CI গেট এবং একটি গেটওয়ে ম্যানিফেস্ট জেনারেশন স্ক্রিপ্ট। ডকুমেন্টেশন একটি অ্যাকশন রেফারেন্স, প্লাগইন এক্সটেনশন আর্কিটেকচার, টেস্টিং এবং একটি রোডম্যাপ কভার করে।