Defining resources

MCP सर्वर में रिसोर्सेज (Resources) की मुख्य अवधारणाएँ

परिचय और उद्देश्य:

• रिसॉर्स (Resources): MCP सर्वर की वह सुविधा जो क्लाइंट को डेटा (data) एक्सपोज़ करने की अनुमति देती है।
• मुख्य उपयोग: उपयोगकर्ता को @ सिंबल का उपयोग करके दस्तावेज़ (document) का उल्लेख करने की अनुमति देना।
• कार्यप्रणाली:
• ऑटो-कम्प्लीट (Autocomplete): @ टाइप करने पर उपलब्ध सभी दस्तावेज़ों की सूची दिखाना।
• सामग्री पुनर्प्राप्ति (Content Retrieval): संदेश सबमिट होने पर, सर्वर को उस दस्तावेज़ की सामग्री (content) प्राप्त करके प्रॉम्प्ट में डालनी होती है।

रिसॉर्स के प्रकार:

• डायरेक्ट/स्टैटिक रिसोर्स (Direct/Static Resources):
• इनका URI (address) हमेशा स्थिर (fixed) होता है।
• उदाहरण: docs://documents
• टेम्पलेटेड रिसोर्स (Templated Resources):
• इनके URI में पैरामीटर या वाइल्डकार्ड (wildcard) होते हैं।
• उदाहरण: docs://documents/{doc_id}
• जब क्लाइंट अनुरोध करता है, तो SDK स्वचालित रूप से URI से पैरामीटर निकालता है और उन्हें फ़ंक्शन के लिए कीवर्ड आर्गुमेंट (keyword argument) के रूप में प्रदान करता है।

कार्यान्वयन (Implementation) के मुख्य बिंदु:

• दो रिसोर्स की आवश्यकता:
• दस्तावेज़ सूची (List Documents): ऑटो-कम्प्लीट के लिए सभी दस्तावेज़ों के नाम (IDs) वापस करना।
• एकल दस्तावेज़ पढ़ें (Read Single Document): एक विशिष्ट दस्तावेज़ ID के आधार पर उसकी सामग्री वापस करना।
• Mime Type: यह क्लाइंट को संकेत देता है कि सर्वर किस प्रकार का डेटा वापस कर रहा है (जैसे: application/json या text/plain)।
• डेटा फ्लो:
• क्लाइंट MCP सर्वर को URI के माध्यम से रीड रिसोर्स रिक्वेस्ट भेजता है।
• MCP सर्वर URI को देखता है और संबंधित फ़ंक्शन को चलाता है।
• फ़ंक्शन का परिणाम क्लाइंट को रीड रिसोर्स रिजल्ट मैसेज के रूप में वापस भेजा जाता है।

उदाहरण (Code Structure):

• लिस्ट डॉक्स (List Docs):
• URI: docs://documents
• Mime Type: application/json
• रिटर्न: दस्तावेज़ IDs की सूची (list of strings)।
• फ़ेच डॉक (Fetch Doc):
• URI: docs://documents/{doc_id} (टेम्पलेटेड)
• Mime Type: text/plain
• इनपुट: doc_id (कीवर्ड आर्गुमेंट के रूप में प्राप्त होता है)।
• रिटर्न: दस्तावेज़ की सामग्री (string)।

Takeaways

• MCP रिसोर्सेज क्लाइंट को @ सिंबल के माध्यम से डेटा (डॉक्यूमेंट) एक्सेस करने की सुविधा देते हैं, जिसका उपयोग ऑटो-कम्प्लीट और सामग्री पुनर्प्राप्ति के लिए होता है।
• रिसॉर्स दो प्रकार के होते हैं: डायरेक्ट/स्टैटिक (स्थिर URI) और टेम्पलेटेड (URI में पैरामीटर या वाइल्डकार्ड का उपयोग होता है)।
• कार्यान्वयन के लिए दो मुख्य रिसोर्स की आवश्यकता होती है: दस्तावेज़ों की सूची (ऑटो-कम्प्लीट के लिए) और एकल दस्तावेज़ पढ़ने के लिए फ़ंक्शन।
• डेटा फ्लो में क्लाइंट URI के माध्यम से रिक्वेस्ट भेजता है, सर्वर संबंधित फ़ंक्शन चलाता है, और परिणाम क्लाइंट को रीड रिसोर्स रिजल्ट के रूप में वापस भेजता है।