عن المشروع

MCP for Blender هو إضافة مبنية من قبل المجتمع تربط Blender 3D بأي LLM (مثل Claude أو Codex أو Cursor) عبر بروتوكول سياق النموذج (MCP). يتيح لك إنشاء وتعديل ومعالجة مشاهد ثلاثية الأبعاد باستخدام أوامر اللغة الطبيعية. ## الميزات الرئيسية - **اتصال ثنائي الاتجاه**: ربط المساعدين الذكيين بـ Blender عبر خادم قائم على المقابس - **التلاعب بالكائنات**: إنشاء وتعديل وحذف الكائنات ثلاثية الأبعاد - **التحكم في المواد**: تطبيق وتعديل المواد والألوان - **تنفيذ الكود**: تشغيل كود Python عشوائي في Blender من الذكاء الاصطناعي - **توليد الأصول والنماذج**: الاستيراد من Poly Haven و Sketchfab و Poly Pizza والنماذج المولدة بالذكاء الاصطناعي عبر Hyper3D Rodin و Hunyuan3D ## كيف يعمل تتكون الإضافة من جزأين رئيسيين: 1. **خادم MCP** (`src/blender_mcp/server.py`) - خادم Python ينفذ بروتوكول سياق النموذج 2. **إضافة Blender** - لوحة جانبية في عرض Blender ثلاثي الأبعاد تبدأ الاتصال ## الإعداد 1. قم بتثبيت `uv` (مدير حزم Python) باستخدام المثبت الرسمي 2. قم بتثبيت إضافة Blender (إما عبر سطر الأوامر أو يدويًا من خلال تفضيلات Blender) 3. قم بتكوين عميل MCP الخاص بك (Claude Desktop أو Claude Code أو Codex أو Cursor أو VS Code أو غيرها) 4. في Blender، اضغط `N` لفتح الشريط الجانبي، وابحث عن علامة التبويب **MCP for Blender**، وانقر على **Start MCP Server** ## القدرات - تنفيذ أي كود Python في Blender - تنزيل النماذج والأصول وملفات HDRIs من Poly Haven - البحث والتنزيل من Sketchfab - البحث والتنزيل من Poly Pizza - توليد نماذج ثلاثية الأبعاد عبر Hyper3D Rodin و Hunyuan3D (Tencent Cloud) ## أمثلة على الأوامر - "أنشئ مشهدًا منخفض البولي في زنزانة، مع تنين يحرس وعاءً من الذهب" - "أعطني صورة مرجعية، وأنشئ مشهد Blender منها" - "قم بتوليد نموذج ثلاثي الأبعاد لقزم حديقة عبر Hyper3D" - "املأ هذه الغرفة بأثاث منخفض البولي من Poly Pizza" ## التكوين تسمح متغيرات البيئة بالتخصيص: - `BLENDER_HOST` (الافتراضي: `localhost`) - `BLENDER_PORT` (الافتراضي: `9876`) - `BLENDER_MCP_SAFE_MODE` - اضبطه على `1` للتحقق من صحة البرامج النصية قبل التنفيذ ## اعتبارات الأمان - لا يحتوي خادم المقابس في الإضافة على مصادقة أو تشفير - افتراضيًا، يمكن للذكاء الاصطناعي تشغيل أي كود Python في Blender - الوضع الآمن (`BLENDER_MCP_SAFE_MODE=1`) يمنع العمليات الخطرة مثل إدخال/إخراج الملفات أو الوصول إلى الشبكة أو تثبيت الكود الدائم ## بيانات الاعتماد الدائمة للواجهة البرمجية قم بتخزين مفاتيح API لـ Sketchfab و Poly Pizza و Hyper3D و Hunyuan3D في تفضيلات Blender أو عبر متغيرات البيئة للإعدادات غير التفاعلية أو CI. ## دعم Docker يمكن تشغيل خادم MCP في حاوية بدلاً من تثبيته محليًا. لا يزال Blender يعمل على جهازك؛ تستضيف الحاوية خادم MCP فقط وتتصل بإضافة Blender. ## إخلاء المسؤولية هذا تكامل من طرف ثالث وليس من صنع Blender.