دليل تدريبي عملي

ربط Blender مع Codex عبر MCP

شرح واضح خطوة بخطوة على Windows، للتحكم في Blender باللغة العربية من داخل Codex في Visual Studio Code.

Codex / VS Code→MCP Server→BlenderMCP Add-on→Blender
Blenderإصدار حديث يدعم إضافات Python.
VS Codeمع إضافة Codex مفعّلة.
Windowsمع PowerShell واتصال بالإنترنت أثناء التثبيت.
النتيجة: تكتب داخل Codex: «أنشئ كرة حمراء فوق المكعب»، فينفذ Blender الأمر مباشرة.
1

تنزيل وتثبيت إضافة Blender MCP

افتح مستودع المشروع:

https://github.com/ahujasid/blender-mcp

افتح ملف addon.py ثم اضغط Raw واحفظه باسم:

addon.py
افتح الملف بالمفكرة وتأكد أنه يحتوي على import bpy، ولا يبدأ بـ <!DOCTYPE html>.

داخل Blender:

Edit → Preferences → Add-ons → Install from Disk

اختر الملف ثم فعّل إضافة Blender MCP.

2

إظهار لوحة BlenderMCP وتشغيل الاتصال

  1. ارجع إلى نافذة العرض الثلاثي الأبعاد.
  2. ضع مؤشر الماوس داخل النافذة واضغط N.
  3. اختر تبويب BlenderMCP.
  4. اضغط Connect to MCP server.
عند نجاح التشغيل يتحول الزر غالبًا إلى Disconnect from MCP server. اترك Blender مفتوحًا.
3

تثبيت UV والتحقق من uvx

افتح PowerShell ونفّذ:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

ثم اختبر:

uvx --version

إذا لم يعمل داخل VS Code فاستخدم المسار الكامل:

C:\Users\Shaye\.local\bin\uvx.exe --version
4

إضافة Blender MCP إلى Codex

افتح ملف الإعداد:

C:\Users\Shaye\.codex\config.toml

أضف في نهايته:

[mcp_servers.blender] command = "C:\\Users\\Shaye\\.local\\bin\\uvx.exe" args = ["blender-mcp"] startup_timeout_sec = 30 tool_timeout_sec = 120 enabled = true
لا تحذف الإعدادات السابقة. احفظ الملف، ثم أغلق VS Code بالكامل وافتحه من جديد.
5

اختبار قراءة المشهد

اكتب داخل Codex:

استخدم خادم Blender MCP وافحص المشهد الحالي، ثم أخبرني بالمجسمات الموجودة.

يفترض أن يذكر: Cube وLight وCamera.

ظهور هذه العناصر يعني أن Codex استطاع قراءة Blender بنجاح.
6

اختبار تنفيذ أمر داخل Blender

أنشئ كرة فوق المكعب مباشرة، واجعل لونها أحمر وحجمها نصف حجم المكعب.
  • قراءة المشهد
  • إنشاء المجسمات
  • تعديل الخامات
  • التحكم في الكاميرا والإضاءة
✓

طريقة التشغيل في كل مرة

  1. افتح Blender.
  2. اضغط N وافتح تبويب BlenderMCP.
  3. اضغط Connect to MCP server.
  4. افتح VS Code ثم Codex.
  5. ابدأ محادثة جديدة واكتب طلبك.
لا تحتاج إلى إعادة تثبيت الإضافة أو تعديل config.toml في كل مرة.
★

تمرين عملي للمتدربين

استخدم Blender MCP. احذف المكعب الافتراضي، ثم أنشئ أرضية خضراء وبيتًا ريفيًا صغيرًا وطريقًا يؤدي إليه. أضف بوابة عند مدخل المزرعة، وضع فوقها نصًا ثلاثي الأبعاد واضحًا: Shaye Alshaye ثم أضف إضاءة صباحية واضبط الكاميرا لتظهر البوابة والبيت والطريق في لقطة واحدة. لا تبدأ الرندر النهائي.
!

حل المشكلات الشائعة

لم تظهر الإضافة

تأكد أن addon.py ملف Python خام وليس صفحة HTML.

uvx يعمل في PowerShell ولا يعمل في VS Code

أغلق VS Code بالكامل أو استخدم المسار الكامل: C:\Users\Shaye\.local\bin\uvx.exe

Codex لا يرى Blender

تأكد أن زر الاتصال أصبح Disconnect، ثم أعد تشغيل VS Code وابدأ محادثة جديدة.

المشهد الكبير يتوقف

ارفع tool_timeout_sec إلى 240 أو أكثر.

تنبيه: احفظ نسخة من ملف Blender قبل الأوامر الكبيرة؛ لأن MCP يستطيع تعديل وحذف العناصر وتشغيل Python.