Defining resources

MCP सर्वर में रिसोर्सेज (Resources) की समझ

यह नोट्स MCP सर्वर में 'Resources' फीचर के कार्यान्वयन और उसके उपयोग पर आधारित हैं, जिसका उद्देश्य यूजर के मैसेज में डॉक्यूमेंट (Document) को स्वचालित रूप से शामिल करना है।

मुख्य अवधारणाएँ (Key Concepts):

• Resources का उद्देश्य: Resources MCP सर्वर को क्लाइंट (Client) के लिए डेटा एक्सपोज (expose) करने की अनुमति देते हैं।
• उपयोग का मामला (Use Case): यूजर जब मैसेज में @ सिंबल का उपयोग करता है, तो सिस्टम को दो काम करने होते हैं:
• Autocomplete: उपलब्ध सभी डॉक्यूमेंट्स की सूची दिखाना।
• Content Fetching: यूजर द्वारा चुने गए विशिष्ट डॉक्यूमेंट की सामग्री (Content) को प्राप्त करना और उसे प्रॉम्प्ट में जोड़ना।
• डिज़ाइन सिद्धांत: प्रत्येक विशिष्ट रीड ऑपरेशन (Read Operation) के लिए एक अलग Resource परिभाषित किया जाता है।

Resources के प्रकार (Types of Resources):

• Direct/Static Resource:
• इनका URI हमेशा स्थिर (fixed) होता है।
• उदाहरण: docs://documents
• Templated Resource:
• इनके URI में पैरामीटर या वाइल्डकार्ड (wildcard) होते हैं।
• ये यूजर द्वारा प्रदान किए गए इनपुट को स्वचालित रूप से फंक्शन के लिए कीवर्ड आर्गुमेंट (keyword argument) के रूप में पार्स (parse) करते हैं।
• उदाहरण: docs/document_id (यहाँ document_id एक टेम्पलेट है)।

कार्यप्रवाह (Workflow - Client to Server):

• क्लाइंट एक्शन: यूजर @ टाइप करता है।
• रिक्वेस्ट: क्लाइंट MCP क्लाइंट के माध्यम से MCP सर्वर को एक 'Read Resource Request' भेजता है, जिसमें URI शामिल होता है।
• सर्वर प्रोसेसिंग: MCP सर्वर URI को देखता है और उससे जुड़ी फंक्शन को चलाता है।
• रिस्पॉन्स: सर्वर परिणाम को 'Read Resource Result' के रूप में क्लाइंट को वापस भेजता है।

कार्यान्वयन (Implementation Details):

• Resource 1: सभी डॉक्यूमेंट IDs की सूची प्राप्त करना (List Docs):
• URI: docs://documents (Static)
• MIME Type: application/json (यह संकेत देता है कि डेटा JSON फॉर्मेट में है)।
• रिटर्न: डॉक्यूमेंट IDs की एक सूची (List of strings)।
• Resource 2: विशिष्ट डॉक्यूमेंट की सामग्री प्राप्त करना (Fetch Doc):
• URI: docs/document_id (Templated)
• MIME Type: text/plain (यह संकेत देता है कि डेटा सादा टेक्स्ट है)।
• इनपुट: doc_id (यह टेम्पलेट से प्राप्त कीवर्ड आर्गुमेंट है)।
• लॉजिक: पहले यह जांचा जाता है कि doc_id मौजूद है या नहीं। यदि मौजूद है, तो उसकी सामग्री (content) वापस की जाती है।

महत्वपूर्ण शब्दावली (Key Terms):

• URI: Resource का पता (Address)।
• MIME Type: यह क्लाइंट को बताता है कि सर्वर किस प्रकार का डेटा (जैसे JSON, Plain Text, Binary) वापस कर रहा है।
• Keyword Argument: Templated Resource में URI के वाइल्डकार्ड से प्राप्त पैरामीटर, जो सीधे सर्वर फंक्शन में उपयोग होते हैं।

Takeaways

• Resources MCP सर्वर को क्लाइंट के लिए डेटा एक्सपोज करने की अनुमति देते हैं, जिसका उपयोग मुख्य रूप से ऑटो-कम्प्लीट और कंटेंट फेचिंग के लिए किया जाता है।
• Resources दो प्रकार के होते हैं: Static (स्थिर URI, जैसे docs://documents) और Templated (URI जिसमें पैरामीटर या वाइल्डकार्ड होते हैं, जैसे docs/document_id)।
• Templated Resources में URI के वाइल्डकार्ड से प्राप्त इनपुट सीधे सर्वर फंक्शन में 'Keyword Argument' के रूप में उपयोग किए जाते हैं।
• कार्यप्रवाह में, क्लाइंट एक 'Read Resource Request' भेजता है, जिसे सर्वर प्रोसेस करके 'Read Resource Result' के रूप में वापस भेजता है।