इस प्रोजेक्ट के बारे में

MCP for Blender एक सामुदायिक-निर्मित प्लगइन है जो Blender 3D को Model Context Protocol (MCP) के माध्यम से किसी भी LLM (जैसे Claude, Codex, या Cursor) से जोड़ता है। यह आपको प्राकृतिक भाषा प्रॉम्प्ट का उपयोग करके 3D सीन बनाने, संशोधित करने और हेरफेर करने की सुविधा देता है। ## मुख्य विशेषताएं - **दो-तरफा संचार**: सॉकेट-आधारित सर्वर के माध्यम से AI सहायकों को Blender से जोड़ें - **ऑब्जेक्ट मैनिपुलेशन**: 3D ऑब्जेक्ट बनाएं, संशोधित करें और हटाएं - **मटेरियल नियंत्रण**: मटेरियल और रंग लागू करें और संशोधित करें - **कोड निष्पादन**: AI से Blender में मनमाना Python कोड चलाएं - **एसेट और मॉडल जनरेशन**: Poly Haven, Sketchfab, Poly Pizza, और Hyper3D Rodin तथा Hunyuan3D के माध्यम से AI-जनित मॉडल आयात करें ## यह कैसे काम करता है इस प्लगइन में दो मुख्य भाग होते हैं: 1. **MCP सर्वर** (`src/blender_mcp/server.py`) - Model Context Protocol लागू करने वाला एक Python सर्वर 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 से मॉडल, एसेट और HDRI डाउनलोड करें - 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 क्रेडेंशियल हेडलेस/CI सेटअप के लिए Sketchfab, Poly Pizza, Hyper3D और Hunyuan3D के API कुंजियों को Blender की प्राथमिकताओं में या पर्यावरण चर के माध्यम से संग्रहीत करें। ## Docker समर्थन MCP सर्वर को स्थानीय रूप से इंस्टॉल करने के बजाय कंटेनर में चलाया जा सकता है। Blender अभी भी आपकी मशीन पर चलता है; कंटेनर केवल MCP सर्वर को होस्ट करता है और Blender ऐडऑन से बाहर कनेक्ट होता है। ## अस्वीकरण यह एक तृतीय-पक्ष एकीकरण है और Blender द्वारा नहीं बनाया गया है।