Defining resources

MCP सर्वर में रिसोर्सेज (Resources) पर अध्ययन नोट्स

मुख्य उद्देश्य:

• उपयोगकर्ता को संदेश में दस्तावेज़ (Documents) का उल्लेख करने की अनुमति देना (जैसे: @report. pdf)।
• MCP सर्वर के माध्यम से दस्तावेज़ की सामग्री को स्वचालित रूप से प्राप्त करना और उसे प्रॉम्प्ट (Prompt) में जोड़ना।

फीचर के दो मुख्य पहलू:

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

MCP रिसोर्सेज की कार्यप्रणाली:

• परिभाषा: रिसोर्सेज MCP सर्वर को क्लाइंट (Client) के लिए डेटा एक्सपोज (expose) करने की अनुमति देते हैं।
• कार्य: प्रत्येक विशिष्ट रीड ऑपरेशन (Read Operation) के लिए एक रिसोर्स परिभाषित किया जाता है।
• प्रक्रिया:
• क्लाइंट MCP क्लाइंट के माध्यम से सर्वर को एक 'रीड रिसोर्स रिक्वेस्ट' भेजता है।
• इस रिक्वेस्ट में रिसोर्स का पता (URI) शामिल होता है।
• MCP सर्वर URI के आधार पर संबंधित फ़ंक्शन को चलाता है।
• परिणाम 'रीड रिसोर्स रिजल्ट' के रूप में क्लाइंट को वापस भेजा जाता है।

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

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

कार्यान्वयन उदाहरण (Implementation Example):

• पहला रिसोर्स (सभी दस्तावेज़ों की सूची):
• URI: docs://documents (Static)
• कार्य: सभी दस्तावेज़ों के IDs (नाम) की सूची लौटाना।
• MIME Type: application/json (संरचित डेटा के लिए)।
• दूसरा रिसोर्स (एक दस्तावेज़ की सामग्री):
• URI: docs://documents/{doc_id} (Templated)
• कार्य: दिए गए doc_id के आधार पर दस्तावेज़ की सामग्री लौटाना।
• MIME Type: text/plain (सादा पाठ लौटाने के लिए)।

निष्कर्ष:

• टेम्पलेटेड रिसोर्सेज का उपयोग तब किया जाता है जब हमें क्लाइंट से अधिक चयन या कस्टमाइज़ेशन की आवश्यकता होती है।
• MCP सर्वर डेटा को JSON या Plain Text जैसे विभिन्न MIME प्रकारों में लौटा सकता है।

Takeaways

• MCP रिसोर्सेज सर्वर को क्लाइंट के लिए डेटा एक्सपोज करने की अनुमति देते हैं, जिससे उपयोगकर्ता द्वारा संदर्भित दस्तावेज़ की सामग्री को स्वचालित रूप से प्राप्त किया जा सके।
• रिसोर्सेज दो प्रकार के होते हैं: डायरेक्ट/स्टैटिक (स्थिर URI) और टेम्पलेटेड (URI में पैरामीटर/वाइल्डकार्ड)।
• टेम्पलेटेड रिसोर्स में, MCP SDK क्लाइंट रिक्वेस्ट से URI के पैरामीटर्स को स्वचालित रूप से निकालता है और उन्हें फ़ंक्शन के कीवर्ड आर्गुमेंट के रूप में प्रदान करता है।
• डेटा प्राप्त करने की प्रक्रिया में, क्लाइंट 'रीड रिसोर्स रिक्वेस्ट' भेजता है, और सर्वर परिणाम को JSON या Plain Text जैसे विशिष्ट MIME Type में लौटाता है।