Install
"command": "npx",
"args": ["-y", "ue-mcp@latest", "C:/path/to/MyGame.uproject"]لمن هذه الأداة
مطوّرون وفنانون تقنيون يعملون على مشاريع Unreal Engine في Windows (UE 5.4-5.8) أو Linux/macOS (UE 5.6+) ويريدون قيادة المحرر بلغة طبيعية من عميل MCP. يذكر الوصف الرسمي أنها توفر 29 فئة أدوات و2040+ إجراء تغطي Blueprints والمواد والمستويات وActor والتحريك وVFX وLandscape وPCG وFoliage والصوت وUI والفيزياء والملاحة والذكاء الاصطناعي والشبكات وSequencer ومسار البناء، إضافة إلى محرك تدفق YAML لسير العمل متعدد الخطوات. الأداة أنسب ما تكون إذا كان يومك يمضي في بناء المشاهد وتعديل الأصول بشكل متكرر داخل المحرر، أو أردت تسليم جزء من أعمال المحرر إلى الذكاء الاصطناعي؛ أما خط أنابيب يعمل دون فتح المحرر فلا حاجة له بها. الاختبار بسيط: هل يُنجز معظم عملك اليومي داخل المحرر، وهل تقبل أن يعدّل النموذج أصول المشروع مباشرة؟ تابع القراءة فقط إذا كان الجواب نعم في الحالتين.
الشرط المسبق اكتمال سلسلة الأدوات المحلية: Node.js 18 أو أحدث؛ وPythonScriptPlugin المضمّن في المحرك (يأتي معه، وinit يفعّل لك بقية الإضافات المطلوبة)؛ وسلسلة أدوات C++ إلزامية — في Windows يعني ذلك Visual Studio بحِمل C++، وفي macOS أدوات سطر أوامر Xcode — لأن إضافة الجسر تُبنى عند أول تشغيل للمحرر. الأجهزة التي لا تملك سلسلة C++ أو التي لا تريد نشر إضافة C++ داخل مشروعها لا تناسبها؛ وكل ما يحتاج فئة epic يتطلب UE 5.8+. ولاحظ أيضًا أن نشر الإضافة يتم لكل مشروع على حدة: عند الانتقال إلى مشروع آخر عليك إعادة تشغيل init التفاعلي لنشر إضافة الجسر هناك وانتظار بنائها عند أول تشغيل لمحرر ذلك المشروع؛ خطوات الانتقال الكاملة غير مذكورة في الأدلة، فهي غير مؤكدة. كما لم تذكر الأدلة الترخيص أو التكاليف أو أي متطلبات إضافية على حجم المشروع، فتحقق منها بنفسك.
أول تجربة في 3 دقائق
المسار الرئيسي الموصى به: تشغيل الخادم عبر npx في إعدادات عميل MCP وجعله يشير إلى ملف .uproject الخاص بك. الشرط: أن تكون UE وNode.js 18+ وسلسلة أدوات C++ المذكورة أعلاه مثبتة.
أضف المقطع الرسمي إلى إعدادات العميل:
"command": "npx",
"args": ["-y", "ue-mcp@latest", "C:/path/to/MyGame.uproject"]
استبدل C:/path/to/MyGame.uproject بمسار ملف مشروعك. التشغيل الأول يدخل في إعداد تفاعلي: يكتشف .uproject في المجلد الحالي تلقائيًا، ويدعك تختار فئات الأدوات التي تريد تفعيلها، وينشر إضافة جسر C++ داخل المشروع، ويفعّل إضافات UE المطلوبة (Niagara وPCG وGAS وغيرها)، ثم يكتشف عميل MCP لديك ويضبطه.
إشارات النجاح: بعد أن ينهي أول تشغيل للمحرر بناء الإضافة، تظهر فئات أدوات الخادم في العميل؛ أصدر أمرًا واحدًا بلغة طبيعية إلى المحرر المفتوح وراقب استجابة فعلية داخل المحرر. إن تأخر ظهور الفئات فراجع أولًا صحة مسار المشروع في الإعدادات، ثم انتظر انتهاء البناء الأول.
تنبيه: يُقدَّم رسميًا على أنه وصول عميق للقراءة والكتابة إلى المحرر لمساعدي الذكاء الاصطناعي، وتغيّر عمليات الكتابة محتوى المشروع مباشرة؛ الأدلة لا تذكر أسماء الأدوات الفردية ولا وسم كل منها بالقراءة أو الكتابة، لذا لا يمكن تعيين أداة قراءة فقط بعينها كأول استدعاء. جرّبها أولًا على مشروع تحت إدارة إصدارات أو مع نسخة احتياطية، واطلب من الذكاء الاصطناعي أن يشرح ما سينفذه قبل أن يعمل.
حالات الاستخدام
الحالة الأولى: تعديل المستويات والعناصر بلغة طبيعية. بعد فتح المحرر صف التغيير المطلوب في المشهد بجملة واحدة في العميل، فيستدعي الخادم أدوات فئتَي المستويات وActor وينفذها في المحرر. المتوقع: كلا المجالين ضمن النطاق القابل للبرمجة بلغة طبيعية المعلن رسميًا. أسماء الأدوات ومعاملاتها المحددة غير مذكورة في الأدلة، فاعتبر الأدوات التي تظهر فعلًا في العميل مرجعك. عند الشك شغّلها أولًا في مشروع تجريبي ثم عد إلى مشروعك الفعلي.
الحالة الثانية: تنفيذ سير عمل متعدد الخطوات بمحرك تدفق YAML. عندما لا تكفي الجملة الواحدة وتحتاج إلى سلسلة ثابتة من عمليات المحرر، صِف التدفق متعدد الخطوات بمحرك YAML المدمج وسلّمه للخادم. المؤكد: المحرك موجود وموجّه لسير العمل متعدد الخطوات؛ صيغة YAML وأمثلتها غير متوفرة في الأدلة، فراجع الوثائق الرسمية قبل البدء. إن تعذّر كتابة التدفق فتحقق أولًا من كل خطوة بأوامر مفردة ثم اربطها في تدفق واحد.
حدود الاستخدام
طبيعة الوصول: ما يُمنح رسميًا هو وصول للقراءة والكتابة، لا خدمة قراءة فقط، ولا يوفَّر أي مسار للتراجع، فلا تعتبر عمليات الكتابة قابلة للتراجع؛ وقبل أن يتدخل الذكاء الاصطناعي تأكد مما سيغيّره في المشروع. الأثر المحلي: التثبيت ينشر إضافة جسر C++ داخل المشروع ويفعّل إضافات UE؛ وفي التشغيل يتصل العميل بالخادم عبر stdio، ثم يتصل الخادم بالإضافة داخل المحرر عبر WebSocket JSON-RPC. أي الفئات تُفعَّل قرارك في مرحلة الإعداد، فاترك ما لا تحتاجه الآن معطلًا لتبقى مساحة الانكشاف أصغر. الأدلة لا تقول شيئًا عن الوصول إلى شبكات خارجية أو القياس عن بُعد وجمع البيانات أو الحاجة إلى بيانات اعتماد، ولا عن سلوك عدة عملاء متصلين بالمشروع نفسه؛ كل ذلك غير مؤكد. غياب البيان ليس غياب الخطر، فبلّغ هذه الحدود مسبقًا لكل من سيستخدم الأداة.