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

Blender MCP

بواسطة ahujasid · ahujasid/blender-mcp

تحكّم في Blender من Claude — نمذجة مشاهد ثلاثية الأبعاد، تشغيل عمليات Python، جلب أصول HDRI من PolyHaven ونماذج Hyper3D rodin، كل ذلك من المحادثة.

Blender MCP يربط Claude بنسخة Blender قيد التشغيل عبر إضافة Python. يمكن لـ Claude فحص المشهد والتعامل مع الكائنات وتنفيذ Python الخاص بـ Blender (bpy) بشكل اعتباطي وضبط المواد وجلب أصول PBR المجانية من PolyHaven ونماذج ثلاثية الأبعاد مولّدة بالذكاء الاصطناعي من Hyper3D. انتشر بشكل واسع في البداية لإنشاء مشاهد كاملة من موجهات نصية.

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

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

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

عرض مباشر

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

blender-mcp-ahujasid.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "blender-mcp-ahujasid",
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "blender-mcp-ahujasid": {
      "command": {
        "path": "uvx",
        "args": [
          "blender-mcp"
        ]
      }
    }
  }
}

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

claude mcp add blender-mcp-ahujasid -- uvx blender-mcp

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

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

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

بناء مشهد ثلاثي الأبعاد من موجه نصي دون لمس واجهة Blender

👤 المصمّمون والمطورون المستقلون والهواة الذين لا يُتقنون النمذجة ⏱ ~30 min beginner

متى تستخدمه: تريد نموذجاً أولياً لمشهد ثلاثي الأبعاد سريعاً دون تعلّم اختصارات Blender.

المتطلبات الأساسية
  • Blender 3.0 أو أحدث مثبّت — حمّله من blender.org
  • إضافة Blender MCP مفعّلة — Edit > Preferences > Add-ons > Install from disk
الخطوات
  1. ربط Claude بـ Blender
    Open Blender. In the N-panel, click 'Connect to Claude'. Verify connection in chat by listing scene objects.✓ تم النسخ
    → مشهد فارغ مُدرج (Cube, Camera, Light) يؤكد الاتصال المباشر
  2. تركيب المشهد
    Build a low-poly forest clearing: 5 trees in a circle, a campfire in the center, a sleeping bag nearby. Use simple geometry.✓ تم النسخ
    → تظهر الكائنات في نافذة العرض في الوقت الفعلي
  3. إضافة الأجواء
    Search PolyHaven for a sunset HDRI. Apply it. Then add a small fog volume above the ground.✓ تم النسخ
    → المشهد يحمل أجواء مضاءة؛ الضباب مرئي في التصيير

النتيجة: نموذج أولي لمشهد ثلاثي الأبعاد مبني بالكامل عبر المحادثة، جاهز للتحسين.

المزالق
  • ينقطع Blender في منتصف الجلسة — أعد الاتصال من لوحة N؛ الإضافة تستمع على socket محلي

توليد أصول ثلاثية الأبعاد بـ Hyper3D rodin واستيرادها مباشرة

👤 مطورو الألعاب والمصمّمون الأوليون الذين يحتاجون إلى أصول سريعة ⏱ ~20 min intermediate

متى تستخدمه: تحتاج إلى عنصر فريد ولا تريد نمذجته من الصفر أو دفع ثمن أصول الأسواق.

المتطلبات الأساسية
  • مفتاح API لـ Hyper3D rodin (مستوى مجاني متاح) — سجّل في hyper3d.ai؛ عيّن HYPER3D_RODIN_API_KEY
الخطوات
  1. توليد من موجه نصي
    Generate a stylized treasure chest with iron bands using Hyper3D rodin. Import it at origin.✓ تم النسخ
    → تبدأ مهمة التوليد؛ يُستورد الشكل الهندسي عند الاكتمال (~30 ثانية)
  2. التحسين وإعادة الاستيراد إذا لزم
    The mesh is too dense. Decimate to 5k tris and reimport.✓ تم النسخ
    → يحل الشكل الهندسي المُبسَّط محل الأصلي

النتيجة: عنصر ثلاثي الأبعاد مخصص في المشهد، مولَّد ومضبوط دون مغادرة Claude.

المزالق
  • طابور التوليد مشغول في المستوى المجاني — أعد المحاولة بتأخير تصاعدي أو ارقَ إلى مستوى مدفوع

تشغيل عمليات دفعية على كائنات متعددة عبر bpy

👤 المهندسون التقنيون ومهندسو الأنابيب ⏱ ~25 min advanced

متى تستخدمه: تحتاج إلى إجراء جماعي مُضنٍ — إعادة تسمية التسلسل الهرمي، إعادة توجيه المواد، فكّ UV دفعي.

الخطوات
  1. وصف العملية
    Every object starting with 'prop_' should be moved into a 'Props' collection and have its origin set to geometry center.✓ تم النسخ
    → يكتب Claude مقطع bpy ويطلب التأكيد قبل التشغيل
  2. التشغيل مع شبكة أمان
    Show me the script first. If it looks safe, execute. Otherwise revise.✓ تم النسخ
    → السكريبت مرئي؛ يُطبَّق التنفيذ؛ تقرير بعدد الكائنات المتأثرة

النتيجة: عمليات مشهد جماعية تُنجز في ثوانٍ مع سجل تدقيق كامل.

المزالق
  • سكريبت خاطئ يُعطّل Blender — احفظ قبل أي تنفيذ bpy؛ الإضافة لا توفر بيئة معزولة

التركيبات

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

blender-mcp-ahujasid + filesystem

حفظ التصييرات والتصديرات على القرص

After rendering, save the PNG to ~/Renders/today.png via filesystem MCP.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
execute_blender_code code: str أي عملية bpy مباشرة 0
get_scene_info () الاستدعاء الأول لفهم محتوى المشهد 0
get_object_info name: str فحص كائن محدد قبل تعديله 0
polyhaven_search_assets asset_type: hdri|model|texture, categories? البحث عن أصول PBR مجانية 0
polyhaven_download_asset asset_id, resolution جلب وتطبيق HDRI أو ملمس 0
generate_hyper3d_model_via_text prompt: str توليد نموذج ثلاثي الأبعاد بالذكاء الاصطناعي 1 generation credit

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

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

حصة API
PolyHaven: مجاني غير محدود. Hyper3D: المستوى المجاني ~20 توليداً يومياً
الرموز لكل استدعاء
100–800 لكل استدعاء (حالة المشهد قد تكون مطوّلة)
التكلفة المالية
الإضافة مجانية. المستويات المدفوعة لـ Hyper3D تبدأ من 10$/شهر
نصيحة
استخدم Sketchfab وPolyHaven قبل الدفع لتوليدات Hyper3D

الأمان

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

الحد الأدنى من الصلاحيات: blender-bpy-exec filesystem-write (for downloads)
تخزين بيانات الاعتماد: مفتاح Hyper3D في متغير البيئة
نقل البيانات الخارجي: PolyHaven CDN، Hyper3D API

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

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

Connection refused

تأكد من أن Blender مفتوح وأن زر 'Connect to Claude' في الإضافة مفعّل؛ المنفذ الافتراضي 9876

توليد Hyper3D متوقف

تحقق من متغير البيئة HYPER3D_RODIN_API_KEY؛ تحقق من حصة المستوى في hyper3d.ai

الكائن غير موجود بعد التعديل

قد يحمل اسم الكائن لاحقة رقمية (.001) — استخدم get_scene_info لتحديث الحالة

البدائل

Blender MCP مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Unity MCP / Unreal MCPأنابيب عملك تبدأ من محرك الألعاب لا من DCCMCPs المحركات تستهدف وقت التشغيل/المشهد؛ Blender MCP يستهدف التأليف
Cesium MCPتحتاج إلى ثلاثيات الأبعاد الجغرافية المرجعية على نطاق عالميCesium للمشاهد الجغرافية المرجعية؛ Blender للمشاهد الحرة

المزيد

الموارد

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

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

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