mcp-unity MCP — حالات الاستخدام, التثبيت & عرض مباشر

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

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

إنشاء وقراءة وتحديث وحذف (CRUD) المشاهد و GameObjects مع عناصر تحكم التحويل
إضافة وتعديل المكونات، وإنشاء وتعيين المواد
مشغل الاختبارات في نمط التحرير والتشغيل
بث سجلات وحدة التحكم
batch_execute لتجميع عدة استدعاءات أدوات بشكل ذري

عرض مباشر

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

unity-3.replay ▶ جاهز

0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "unity-3": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/CoderGamester/mcp-unity"
      ],
      "_inferred": true
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "unity-3": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/CoderGamester/mcp-unity"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "unity-3": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/CoderGamester/mcp-unity"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "unity-3": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/CoderGamester/mcp-unity"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "unity-3",
      "command": "TODO",
      "args": [
        "See README: https://github.com/CoderGamester/mcp-unity"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "unity-3": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/CoderGamester/mcp-unity"
        ]
      }
    }
  }
}

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

claude mcp add unity-3 -- TODO 'See README: https://github.com/CoderGamester/mcp-unity'

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

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

استخدامات عملية: mcp-unity

كيفية بناء مشهد بسيط من محادثة بأقل تعقيد

👤 مطورو Unity المستقلون ⏱ ~15 min beginner

متى تستخدمه: إذا كنت تريد مكتبة MCP موحدة بدون 100+ أداة تزدحم السياق.

المتطلبات الأساسية

Unity 6 أو إصدار أحدث — unity.com/download
Node 18 أو أحدث — nodejs.org أو nvm
تثبيت الحزمة من عنوان Git — مدير الحزم > + > إضافة من عنوان git: https://github.com/CoderGamester/mcp-unity.git

الخطوات

إنشاء مشهد

أنشئ مشهداً جديداً باسم 'Playground'. أضف Plane و Directional Light و3 مكعبات عند المواضع (-2,0,0) و(0,0,0) و(2,0,0).✓ تم النسخ

→ يظهر المشهد، الأشياء مرئية
ربط التفاعلات

أضف Rigidbody و BoxCollider لكل مكعب. اجعل المكعب عند الأصل حركياً (kinematic).✓ تم النسخ

→ المكونات مرئية عند الفحص
تشغيل الاختبارات

run_tests mode=EditMode. أظهر الأخطاء.✓ تم النسخ

→ مخرجات الاختبار

النتيجة: مشهد عملي + اختبارات ناجحة، كل ذلك من خلال المحادثة.

المزالق

سلوك التراجع في batch_execute متغير — وليس معاملة حقيقية — افترض النجاح الجزئي عند حدوث خطأ؛ تحقق بعد التجميع

اجمعها مع: github

كيفية إنشاء وإنشاء نسخ من ملفات المقدمات من المحادثة

👤 مطورو Unity الذين يبنون أصولاً قابلة لإعادة الاستخدام ⏱ ~15 min intermediate

متى تستخدمه: إذا كنت تريد من الوكيل الحفاظ على مكتبة ملفات مقدمات.

الخطوات

إنشاء ملف مقدمات

بناء GameObject باسم 'Enemy' مع Rigidbody + مكون EnemyAI، ثم create_prefab منه في Assets/Prefabs/Enemy.prefab.✓ تم النسخ

→ تم إنشاء ملف المقدمات
إنشاء نسخة

add_asset_to_scene Assets/Prefabs/Enemy.prefab عند 5 مواضع عشوائية ضمن 50 وحدة من الأصل.✓ تم النسخ

→ تم وضع 5 أعداء

النتيجة: ملف مقدمات Enemy قابل لإعادة الاستخدام + 5 نسخ موضوعة

كيفية التكرار على الإصلاح باستخدام run_tests في حلقة سريعة

👤 مطورو Unity الذين لديهم تغطية اختبارات ⏱ ~15 min intermediate

متى تستخدمه: الخطأ + الاختبار موجود؛ تريد إصلاح سريع red-green-refactor.

الخطوات

رؤية الفشل

run_tests mode=EditMode filter='EnemyAI_ShouldPatrol'. أظهر المكدس.✓ تم النسخ

→ تأكيد فاشل مع رقم السطر
التحرير وإعادة الاختبار

طبق الإصلاح الأدنى، احفظ، وأعد تشغيل الاختبار.✓ تم النسخ

→ اختبار أخضر

النتيجة: اختبار أخضر، ثقة في الإصلاح.

اجمعها مع: github

التركيبات

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

unity-3 + github

تشغيل الاختبارات، ثم الالتزام + فتح طلب دمج للإصلاح

أصلح فشل اختبار EnemyAI، التزم في فرع fix/enemy-patrol، افتح طلب دمج.✓ تم النسخ

الأدوات

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

الأداة	المدخلات	متى تستدعيها	التكلفة
create_scene	name: str	ابدأ مشهداً جديداً	free
load_scene	path: str	افتح مشهداً موجوداً	free
get_gameobject	name_or_id: str	ابحث عن كائن واحد	free
update_gameobject	id, props	إعادة تسمية، إعادة توالد، تبديل النشاط	free
update_component	target, component, values	ضبط حقول المكون	free
create_prefab	source_id, path	التقط كائناً كملف مقدمات	free
add_asset_to_scene	path, position?, rotation?	إنشاء نسخة من أصل/ملف مقدمات	free
run_tests	mode: 'EditMode'\|'PlayMode', filter?	اختبارات الوحدة	free
get_console_logs	since_ms?	فحص الأخطاء	free
batch_execute	calls: Call[]	تجميع عدة استدعاءات أدوات	free

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

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

حصة API: لا توجد — محلي فقط
الرموز لكل استدعاء: صغير؛ هذه المكتبة لديها قائمة أدوات محدودة
التكلفة المالية: مجاني (مفتوح المصدر)
نصيحة: اجمع العمليات ذات الصلة عبر batch_execute لتقليل الرحلات الذهاب والإياب.

الأمان

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

الحد الأدنى من الصلاحيات: الوصول المحلي للمشروع فقط

تخزين بيانات الاعتماد: لا توجد

نقل البيانات الخارجي: خادم محلي؛ يرى نموذج اللغة الكبير ما يعيده أداتك

لا تمنح أبدًا: فتح جسر Node لخادم غير محلي

اختبارات PlayMode تشغل رمز اللعبة — قد تحدث آثار جانبية. التزم أولاً.

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

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

Unity 'package could not be resolved'

يتطلب Unity 6 أو إصدار أحدث. تحقق من الإصدار؛ فشل التثبيت من عنوان git على المحررات الأقدم.

Node bridge crashes on startup

يتطلب Node 18 + npm 9. تحقق من 'node -v' وقم بالترقية.

تحقق: node -v

Tests don't appear

يجب تعريف مجموعات الاختبار في ملفات تعريف المجموعة التي تشير إلى TestRunner.

البدائل

mcp-unity مقابل البدائل

البديل	متى تستخدمها	المقايضة
MCP لـ Unity (CoplayDev)	إذا كنت تريد أكبر سطح أدوات Unity مع تغطية الفيزياء/VFX	أدوات أكثر = تكلفة سياق أعلى
Unity-MCP (IvanMurzak)	إذا كنت تحتاج إلى تنفيذ C# لمرة واحدة مدعوم بـ Roslyn	قوة أكبر، مخاطر أعلى

mcp-unity

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

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

عرض مباشر

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

التثبيت

اختر العميل

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

استخدامات عملية: mcp-unity

كيفية بناء مشهد بسيط من محادثة بأقل تعقيد

المتطلبات الأساسية

الخطوات

المزالق

كيفية إنشاء وإنشاء نسخ من ملفات المقدمات من المحادثة

الخطوات

كيفية التكرار على الإصلاح باستخدام run_tests في حلقة سريعة

الخطوات

التركيبات

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

الأدوات

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

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

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

الأمان

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

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

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

البدائل

mcp-unity مقابل البدائل

المزيد

الموارد