/ الدليل / الملعب / Unity-MCP
← كل الخوادم ↗ GitHub
● مجتمع IvanMurzak ⚡ فوري

Unity-MCP

بواسطة IvanMurzak · IvanMurzak/Unity-MCP

حلقة تطوير واختبار كاملة مدعومة بالذكاء الاصطناعي لـ Unity مع أكثر من 100 أداة، وتنفيذ C# مدعوم بـ Roslyn، وواجهة سطر أوامر CLI لإعداد سريع.

IvanMurzak/Unity-MCP هو ملحق Unity وخادم MCP يعرّض سطحاً واسعاً (المشاهد، GameObjects، المكونات، النماذج الأساسية، المواد، الحزم، لقطات الشاشة، الاختبارات، تنفيذ C# من Roslyn) لأي عميل MCP. يركز على كفاءة الرموز وطبقة AI Skills فوق الأدوات الخام.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

unity-2.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "unity-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/IvanMurzak/Unity-MCP"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "unity-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/IvanMurzak/Unity-MCP"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "unity-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/IvanMurzak/Unity-MCP"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "unity-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/IvanMurzak/Unity-MCP"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "unity-2",
      "command": "TODO",
      "args": [
        "See README: https://github.com/IvanMurzak/Unity-MCP"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "unity-2": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/IvanMurzak/Unity-MCP"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add unity-2 -- TODO 'See README: https://github.com/IvanMurzak/Unity-MCP'

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: Unity-MCP

كيفية معالجة الموارد المستوردة في دفعات باستخدام موجه واحد

👤 فنانو Unity التقنيون ⏱ ~25 min intermediate

متى تستخدمه: عندما يكون لديك 200 نسيج جديد وتريد إعدادات استيراد متسقة، و mip maps، وموضع أطلس.

المتطلبات الأساسية
  • مشروع Unity مفتوح، الملحق مثبت — unity-mcp-cli install-plugin ./MyUnityProject أو استيراد .unitypackage
  • عميل MCP مُكوَّن — وجّه Claude Desktop أو Cursor إلى خادم MCP المحلي المطبوع بواسطة واجهة سطر الأوامر
الخطوات
  1. تدقيق الإعدادات الحالية
    ادرج كل نسيج في Assets/Textures/UI. أظهر إعدادات TextureImporter الحالية مجمعة حسب القيم المستخدمة.✓ تم النسخ
    → مجموعات حسب الإعدادات — في الغالب متسقة مع الحالات الشاذة مُعلمة
  2. تطبيق سياسة
    لكل منها، اضبط compression=HighQuality, filter=Bilinear, mipmaps=false. إعادة استيراد.✓ تم النسخ
    → سجل التقدم + الحالة المتسقة النهائية
  3. تحقق بصرياً
    التقط لقطة شاشة من Scene MainMenu من الكاميرا الافتراضية — تأكد من عدم تعطل أي شيء.✓ تم النسخ
    → تم إرجاع لقطة الشاشة، يمر اختبار العقل

النتيجة: إعدادات استيراد موحدة عبر المجلد + مسار لقطات الشاشة.

المزالق
  • تعيد الاستيراد حجب إعادة تحميل مجال المحرر — احفظ المشهد أولاً؛ لا تصدر أوامر غير ذات صلة حتى تكتمل إعادة الاستيراد
اجمعها مع: filesystem

كيفية تشغيل مقطع C# لمرة واحدة في المحرر بدون كتابة نص برمجي

👤 مطورو Unity يقومون بتنظيف وتجاهل ⏱ ~15 min advanced

متى تستخدمه: تريد التكرار عبر كل نموذج أساسي وإصلاح مرجع معطل — مرة واحدة.

الخطوات
  1. وصف المقطع
    تنفيذ C# عبر Roslyn: التكرار عبر كل نموذج أساسي ضمن Assets/Prefabs، والعثور على مكونات MissingScript، ودرج النموذج الأساسي + معرّف النص المفقود.✓ تم النسخ
    → تقرير بالنماذج الأساسية السيئة
  2. تطبيق الإصلاح
    الآن أزل مكونات MissingScript تلك واحفظ كل نموذج أساسي.✓ تم النسخ
    → عدد النماذج الأساسية المحدثة

النتيجة: مشروع خالٍ من تحذيرات البرامج النصية المفقودة.

المزالق
  • تنفيذ Roslyn له قوة محرر كاملة — مقطع سيء يمكن أن يفسد المشروع — التزم بـ git قبل التشغيل؛ راجع مقطع الكود قبل التنفيذ
اجمعها مع: github

كيفية فحص الانحدار البصري عبر لقطات الشاشة

👤 فريق الاختبار، المطورون المنفردون ⏱ ~10 min beginner

متى تستخدمه: يقول المختبر 'القائمة تبدو خاطئة' وتريد صورة الحقيقة الأرضية بسرعة.

الخطوات
  1. افتح المشهد المريب
    افتح مشهد MainMenu والتقط لقطة شاشة من كاميرا الواجهة عند 1920x1080.✓ تم النسخ
    → تم إرجاع مسار ملف لقطة الشاشة
  2. قارن مع مرجع
    إليك الصورة الذهبية [إرفاق]. صف الاختلافات.✓ تم النسخ
    → استدعاءات محددة (الإزاحات، الألوان، العناصر المفقودة)

النتيجة: تقرير خلل مع دليل صورة مرفق.

اجمعها مع: github

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

unity-2 + github

أتمتة الإعادات الهيكلية + الالتزام + PR من الدردشة

أعد تسمية حقل PlayerController.Speed إلى MoveSpeed في كل مكان، وشغل الاختبارات، والتزم وافتح PR.✓ تم النسخ
unity-2 + filesystem

استيراد نماذج ثلاثية الأبعاد خارجية إلى المشروع

انقل كل .fbx من ~/Downloads/kenney/ إلى Assets/Models/ واضبطها على عدم التمكن من القراءة/الكتابة.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
scene_open path: str تحميل مشهد قبل الفحص أو التعديلات free
gameobject_find query: str تحديد موقع الكائنات free
component_add target, type, values? إرفاق المكونات free
script_create path, body ملف C# جديد free
csharp_execute code: str أتمتة محرر لمرة واحدة free
test_run mode: 'Edit'|'Play', filter? تشغيل اختبارات الوحدة/التشغيل free
screenshot camera?: str, resolution?: {w,h} التحقق البصري free
console_read since_ms? تحقق من الأخطاء بعد التغييرات free

التكلفة والحدود

تكلفة التشغيل

حصة API
لا توجد API بعيدة — كل شيء محلي
الرموز لكل استدعاء
يمكن أن تنمو قوائم المشاهد بشكل كبير؛ حد أقصى مع المرشحات
التكلفة المالية
مجاني، مفتوح المصدر
نصيحة
فضّل الاستعلامات الضيقة (gameobject_find 'Enemy*') على مخاطر الهرمية الكاملة.

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: كتابة نظام الملفات المحلي إلى المشروع
تخزين بيانات الاعتماد: لا شيء — localhost فقط
نقل البيانات الخارجي: Localhost. يستقبل موفر LLM الخاص بك أي محتوى مشهد/نص برمجي يعيده الأداة.
لا تمنح أبدًا: لا تعرّض منفذ HTTP الخاص بـ MCP لواجهات غير loopback

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

Project path contains spaces: tools fail

انقل المشروع إلى مسار بدون مسافات. هذا قيد موثق.

CLI cannot find Unity

اضبط متغير البيئة UNITY_EDITOR_PATH على ملف المحرر الثنائي.

تحقق: $UNITY_EDITOR_PATH -version
csharp_execute throws 'type not found'

يجب أن يكون Unity قد تم تجميعه بنجاح قبل التنفيذ. أصلح وحدة التحكم الحمراء أولاً وأعد تحميل.

البدائل

Unity-MCP مقابل البدائل

البديلمتى تستخدمهاالمقايضة
MCP for Unity (CoplayDev)تريد الخيار الأكثر شهرة مع سطح أداة كبيرلا يوجد تنفيذ C# عشوائي قائم على Roslyn
mcp-unity (CoderGamester)سطح أبسط يركز على المشاهد/الاختباراتأدوات متقدمة أقل

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills