منصوبے کے بارے میں

MCP for Blender ایک کمیونٹی کی بنائی ہوئی پلگ ان ہے جو Blender 3D کو کسی بھی LLM (جیسے Claude، Codex، یا Cursor) سے Model Context Protocol (MCP) کے ذریعے جوڑتی ہے۔ یہ قدرتی زبان کے پرامپٹس کے ذریعے 3D سینز بنانے، تبدیل کرنے، اور ان میں ہیرا پھیری کرنے کی اجازت دیتی ہے۔ ## اہم خصوصیات - **دو طرفہ مواصلات**: ساکٹ پر مبنی سرور کے ذریعے AI معاونین کو Blender سے جوڑیں - **آبجیکٹ ہیرا پھیری**: 3D آبجیکٹس بنائیں، تبدیل کریں، اور حذف کریں - **مٹیریل کنٹرول**: مٹیریل اور رنگوں کو لاگو اور تبدیل کریں - **کوڈ پر عمل**: AI سے Blender میں صوابدیدی Python کوڈ چلائیں - **اثاثہ اور ماڈل جنریشن**: Poly Haven، Sketchfab، Poly Pizza، اور Hyper3D Rodin اور Hunyuan3D کے ذریعے AI سے تیار کردہ ماڈلز درآمد کریں ## یہ کیسے کام کرتا ہے پلگ ان دو اہم حصوں پر مشتمل ہے: 1. **MCP سرور** (`src/blender_mcp/server.py`) - ایک Python سرور جو Model Context Protocol کو نافذ کرتا ہے 2. **Blender ایڈون** - Blender کے 3D ویوپورٹ میں ایک سائیڈبار پینل جو کنکشن شروع کرتا ہے ## سیٹ اپ 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** پر کلک کریں ## صلاحیتیں - Blender میں کوئی بھی Python کوڈ چلائیں - Poly Haven سے ماڈلز، اثاثے، اور HDRIs ڈاؤن لوڈ کریں - Sketchfab سے ماڈلز تلاش اور ڈاؤن لوڈ کریں - Poly Pizza سے لو-پولی ماڈلز تلاش اور ڈاؤن لوڈ کریں - Hyper3D Rodin اور Hunyuan3D (Tencent Cloud) کے ذریعے 3D ماڈلز تیار کریں ## مثال کے احکامات - "ایک تہھانے میں لو-پولی سین بنائیں، جہاں ایک ڈریگن سونے کے برتن کی حفاظت کر رہا ہو" - "ایک حوالہ تصویر دیں، اور اس سے Blender سین بنائیں" - "Hyper3D کے ذریعے باغی بونے کا 3D ماڈل تیار کریں" - "اس کمرے کو Poly Pizza کے لو-پولی فرنیچر سے بھریں" ## ترتیب ماحولیاتی متغیرات حسب ضرورت بنانے کی اجازت دیتے ہیں: - `BLENDER_HOST` (ڈیفالٹ: `localhost`) - `BLENDER_PORT` (ڈیفالٹ: `9876`) - `BLENDER_MCP_SAFE_MODE` - اسکرپٹس پر عمل سے پہلے تصدیق کے لیے `1` پر سیٹ کریں ## سیکیورٹی تحفظات - ایڈون کے ساکٹ سرور میں کوئی تصدیق یا خفیہ کاری نہیں ہے - ڈیفالٹ طور پر، AI Blender میں کوئی بھی Python کوڈ چلا سکتا ہے - سیف موڈ (`BLENDER_MCP_SAFE_MODE=1`) خطرناک کارروائیوں جیسے فائل I/O، نیٹ ورک تک رسائی، یا مستقل کوڈ انسٹالیشن کو روکتا ہے ## مستقل API اسناد Sketchfab، Poly Pizza، Hyper3D، اور Hunyuan3D کے لیے API کلیدیں Blender کی ترجیحات میں یا ہیڈ لیس/CI سیٹ اپ کے لیے ماحولیاتی متغیرات کے ذریعے محفوظ کریں۔ ## Docker سپورٹ MCP سرور مقامی طور پر انسٹال ہونے کے بجائے کنٹینر میں چل سکتا ہے۔ Blender اب بھی آپ کی مشین پر چلتا ہے؛ کنٹینر صرف MCP سرور کی میزبانی کرتا ہے اور Blender ایڈون سے باہر جڑتا ہے۔ ## ڈس کلیمر یہ ایک تھرڈ پارٹی انٹیگریشن ہے اور Blender کی طرف سے نہیں بنائی گئی ہے۔