প্রকল্প সম্পর্কে

গডট এমসিপি হলো একটি মডেল কনটেক্সট প্রোটোকল (MCP) সার্ভার যা এআই এজেন্ট এবং গডট গেম ইঞ্জিনের মধ্যে সেতুবন্ধন তৈরি করে। এটি এআই সহায়কদের গডট প্রজেক্টের সাথে সরাসরি যোগাযোগ করতে সক্ষম করে, যেমন এডিটর চালু করা, ডিবাগ মোডে প্রজেক্ট রান করা, কনসোল আউটপুট ক্যাপচার করা এবং এক্সিকিউশন ফ্লো নিয়ন্ত্রণ করা। সার্ভারটি সিন পরিচালনার ক্ষমতাও প্রদান করে, যার মধ্যে রয়েছে নতুন সিন তৈরি করা, কাস্টম প্রপার্টি সহ নোড যোগ করা, স্প্রাইট লোড করা, 3D সিনকে MeshLibrary রিসোর্স হিসেবে এক্সপোর্ট করা এবং গডট 4.4+ এর জন্য UID রেফারেন্স পরিচালনা করা। ## মূল বৈশিষ্ট্য - **এডিটর ও প্রজেক্ট নিয়ন্ত্রণ**: গডট এডিটর চালু করুন, ডিবাগ মোডে প্রজেক্ট রান করুন এবং প্রোগ্রাম্যাটিকভাবে বন্ধ করুন - **ডিবাগ আউটপুট ক্যাপচার**: রিয়েল-টাইম ফিডব্যাকের জন্য কনসোল আউটপুট এবং ত্রুটি বার্তা সংগ্রহ করুন - **প্রজেক্ট বিশ্লেষণ**: একটি ডিরেক্টরিতে প্রজেক্ট তালিকাভুক্ত করুন, বিস্তারিত প্রজেক্ট কাঠামো তথ্য পান এবং ইনস্টল করা গডট সংস্করণ জানুন - **সিন পরিচালনা**: - নির্দিষ্ট রুট নোড টাইপ সহ নতুন সিন তৈরি করুন - কাস্টমাইজযোগ্য প্রপার্টি সহ বিদ্যমান সিনে নোড যোগ করুন - Sprite2D নোডে স্প্রাইট/টেক্সচার লোড করুন - GridMap-এর জন্য 3D সিনকে MeshLibrary রিসোর্স হিসেবে এক্সপোর্ট করুন - ভেরিয়েন্ট অপশন সহ সিন সংরক্ষণ করুন - **UID পরিচালনা** (গডট 4.4+): ফাইলের জন্য UID পান এবং রিসোর্স পুনরায় সংরক্ষণ করে UID রেফারেন্স আপডেট করুন ## আর্কিটেকচার সার্ভারটি একটি হাইব্রিড পদ্ধতি ব্যবহার করে: 1. **সরাসরি কমান্ড**: সাধারণ অপারেশন (এডিটর চালু, সংস্করণ জানা) গডটের বিল্ট-ইন CLI কমান্ড ব্যবহার করে 2. **বান্ডেলড অপারেশন স্ক্রিপ্ট**: জটিল অপারেশন (সিন তৈরি, নোড ম্যানিপুলেশন) একটি একক বিস্তৃত GDScript ফাইল (`godot_operations.gd`) ব্যবহার করে যা অপারেশন টাইপ এবং প্যারামিটার JSON হিসেবে গ্রহণ করে, ফলে অস্থায়ী ফাইল তৈরি না করেই নমনীয় এক্সিকিউশন সম্ভব হয় ## প্রয়োজনীয়তা - গডট ইঞ্জিন ইনস্টল করা - Node.js (>=18.0.0) এবং npm - একটি MCP-সামঞ্জস্যপূর্ণ এআই এজেন্ট (যেমন, Claude Code, Cursor) ## দ্রুত শুরু Claude Code-এর জন্য: bash claude mcp add godot -- npx @coding-solo/godot-mcp Cursor-এর জন্য, সেটিংসে MCP সার্ভার যোগ করুন কমান্ড `npx @coding-solo/godot-mcp` দিয়ে। ## কনফিগারেশন পরিবেশ পরিবর্তনশীল: - `GODOT_PATH`: গডট এক্সিকিউটেবলের পথ (অটো-ডিটেকশন ওভাররাইড করে) - `DEBUG`: বিস্তারিত সার্ভার-সাইড লগিংয়ের জন্য `"true"` সেট করুন ## সমস্যা সমাধান - **গডট পাওয়া যায়নি**: `GODOT_PATH` পরিবেশ পরিবর্তনশীল সেট করুন - **সংযোগ সমস্যা**: সার্ভার চলছে কিনা নিশ্চিত করুন এবং আপনার এআই সহায়ক পুনরায় চালু করুন - **অবৈধ প্রজেক্ট পাথ**: নিশ্চিত করুন পাথে একটি `project.godot` ফাইল রয়েছে - **বিল্ড সমস্যা**: ডিপেন্ডেন্সি ইনস্টল করতে `npm install` চালান ## লাইসেন্স MIT লাইসেন্স