Roots

MCP सर्वर में रूट सिस्टम (Root System) - मुख्य अवधारणाएँ

• रूट की परिभाषा: रूट एक कोडित तरीका है जिसके द्वारा उपयोगकर्ता किसी सर्वर (MCP Server) को विशिष्ट फ़ाइलों और फ़ोल्डरों तक पहुँच प्रदान करता है।
• समस्या: सामान्यतः, उपयोगकर्ता केवल फ़ाइल का नाम (जैसे biking. mp4) बताता है, लेकिन AI (Claude) पूरे फ़ाइल सिस्टम में खोज नहीं कर सकता। इसलिए, हर बार पूर्ण पथ (Full Path) देना असुविधाजनक होता है।
• रूट का समाधान: रूट एक पूर्व-अनुमोदित (pre-approved) फ़ोल्डर या फ़ाइल होती है, जिसे उपयोगकर्ता सर्वर को पढ़ने की अनुमति देता है।
• आवश्यक टूल्स:
• convert video: मुख्य कार्य करने वाला टूल।
• read directory: किसी विशिष्ट डायरेक्टरी की सामग्री सूचीबद्ध करता है।
• list roots: सर्वर द्वारा एक्सेस किए जा सकने वाले सभी रूट की सूची लौटाता है।
• कार्यप्रणाली (Workflow):
• उपयोगकर्ता एक रूट सेट करता है (जैसे desktop फ़ोल्डर)।
• AI पहले list roots टूल का उपयोग करके उपलब्ध रूट की सूची देखता है।
• AI read directory का उपयोग करके उस रूट के अंदर फ़ाइल खोजता है।
• AI को फ़ाइल का पूर्ण पथ मिल जाने पर वह convert video टूल को कॉल करता है।
• रूट के दो मुख्य उद्देश्य:
• सुरक्षा: यह सुनिश्चित करना कि सर्वर केवल अनुमत फ़ाइलों/फ़ोल्डरों तक ही पहुँच सके।
• दक्षता: AI को पूरे फ़ाइल सिस्टम में खोजने के बजाय, केवल निर्दिष्ट क्षेत्रों (Roots) पर ध्यान केंद्रित करने देना।
• महत्वपूर्ण कार्यान्वयन नोट:
• MCP SDK स्वचालित रूप से एक्सेस को सीमित नहीं करता है।
• MCP सर्वर को यह सुनिश्चित करने के लिए कोड (जैसे is path allowed फ़ंक्शन) लागू करना होता है कि कोई भी टूल किसी फ़ाइल या फ़ोल्डर को एक्सेस करने से पहले वह रूट के भीतर स्थित हो।
• वैकल्पिक तरीका: list roots टूल बनाने के बजाय, रूट की सूची को सीधे प्रॉम्प्ट में मैन्युअल रूप से दिया जा सकता है।

Takeaways

• रूट (Root) एक पूर्व-अनुमोदित फ़ोल्डर है जो MCP सर्वर को विशिष्ट फ़ाइलों और फ़ोल्डरों तक पहुँच प्रदान करने का एक कोडित तरीका है।
• इसका मुख्य उद्देश्य सुरक्षा (केवल अनुमत क्षेत्रों तक पहुँच सुनिश्चित करना) और दक्षता (पूरे फ़ाइल सिस्टम में खोज से बचना) प्रदान करना है।
• कार्यप्रणाली में, AI पहले list roots और read directory टूल का उपयोग करके फ़ाइल का पूर्ण पथ ढूंढता है, और फिर convert video टूल को कॉल करता है।
• महत्वपूर्ण कार्यान्वयन नोट: MCP SDK स्वचालित रूप से एक्सेस को सीमित नहीं करता है; सर्वर को यह सुनिश्चित करने के लिए कोड लागू करना होता है कि कोई भी टूल रूट के भीतर ही काम करे।