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

Godot MCP एक Model Context Protocol (MCP) सर्वर है जो AI एजेंट्स को Godot गेम इंजन से जोड़ता है। यह AI सहायकों को एडिटर लॉन्च करके, डिबग मोड में प्रोजेक्ट चलाकर, कंसोल आउटपुट कैप्चर करके और निष्पादन प्रवाह को नियंत्रित करके Godot प्रोजेक्ट्स के साथ सीधे इंटरैक्ट करने में सक्षम बनाता है। सर्वर सीन प्रबंधन क्षमताएं भी प्रदान करता है, जिसमें सीन बनाना, कस्टम गुणों वाले नोड्स जोड़ना, स्प्राइट्स लोड करना, 3D सीन्स को MeshLibrary संसाधनों के रूप में निर्यात करना, और Godot 4.4+ के लिए UID संदर्भ प्रबंधित करना शामिल है। ## मुख्य विशेषताएं - **एडिटर और प्रोजेक्ट नियंत्रण**: Godot एडिटर लॉन्च करें, प्रोजेक्ट्स डिबग मोड में चलाएं, और उन्हें प्रोग्रामेटिक रूप से रोकें - **डिबग आउटपुट कैप्चर**: रियल-टाइम फीडबैक के लिए कंसोल आउटपुट और त्रुटि संदेश प्राप्त करें - **प्रोजेक्ट विश्लेषण**: डायरेक्टरी में प्रोजेक्ट्स सूचीबद्ध करें, विस्तृत प्रोजेक्ट संरचना जानकारी प्राप्त करें, और इंस्टॉल किया गया Godot संस्करण प्राप्त करें - **सीन प्रबंधन**: - निर्दिष्ट रूट नोड प्रकारों के साथ नए सीन बनाएं - अनुकूलन योग्य गुणों के साथ मौजूदा सीन में नोड्स जोड़ें - Sprite2D नोड्स में स्प्राइट्स/टेक्सचर लोड करें - GridMap के लिए 3D सीन्स को MeshLibrary संसाधनों के रूप में निर्यात करें - विभिन्न विकल्पों के साथ सीन्स सहेजें - **UID प्रबंधन** (Godot 4.4+): फाइलों के लिए UIDs प्राप्त करें और संसाधनों को फिर से सहेजकर UID संदर्भ अपडेट करें ## आर्किटेक्चर सर्वर एक हाइब्रिड दृष्टिकोण का उपयोग करता है: 1. **प्रत्यक्ष कमांड्स**: सरल ऑपरेशन्स (एडिटर लॉन्च, संस्करण प्राप्त करें) Godot के अंतर्निर्मित CLI कमांड्स का उपयोग करते हैं 2. **बंडल ऑपरेशन स्क्रिप्ट**: जटिल ऑपरेशन्स (सीन निर्माण, नोड हेरफेर) एक व्यापक GDScript फाइल (`godot_operations.gd`) का उपयोग करते हैं जो ऑपरेशन प्रकार और पैरामीटर को JSON के रूप में स्वीकार करती है, जिससे अस्थायी फाइलें उत्पन्न किए बिना लचीला निष्पादन संभव होता है ## आवश्यकताएं - Godot Engine स्थापित - Node.js (>=18.0.0) और npm - MCP-संगत AI एजेंट (जैसे, Claude Code, Cursor) ## त्वरित प्रारंभ Claude Code के लिए: ```bash claude mcp add godot -- npx @coding-solo/godot-mcp ``` Cursor के लिए, सेटिंग्स में MCP सर्वर को कमांड `npx @coding-solo/godot-mcp` के साथ जोड़ें। ## कॉन्फ़िगरेशन पर्यावरण वेरिएबल्स: - `GODOT_PATH`: Godot एक्ज़ीक्यूटेबल का पथ (स्वचालित पहचान को ओवरराइड करता है) - `DEBUG`: विस्तृत सर्वर-साइड लॉगिंग के लिए `"true"` पर सेट करें ## समस्या निवारण - **Godot नहीं मिला**: `GODOT_PATH` पर्यावरण वेरिएबल सेट करें - **कनेक्शन समस्याएं**: सुनिश्चित करें कि सर्वर चल रहा है और अपने AI सहायक को पुनः आरंभ करें - **अमान्य प्रोजेक्ट पथ**: सुनिश्चित करें कि पथ में एक `project.godot` फाइल है - **बिल्ड समस्याएं**: निर्भरताएं स्थापित करने के लिए `npm install` चलाएं ## लाइसेंस MIT लाइसेंस