Defining resources

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

यह नोट्स MCP सर्वर में डेटा एक्सेस और रिसोर्स एक्सपोजर से संबंधित प्रमुख बिंदुओं पर आधारित हैं।

**1. रिसोर्सेज का उद्देश्य (Purpose of Resources):**

• MCP सर्वर का उपयोग क्लाइंट को डेटा (Data) एक्सपोज करने के लिए किया जाता है।
• प्रत्येक विशिष्ट रीड ऑपरेशन (Read Operation) के लिए एक रिसोर्स परिभाषित किया जाता है।

**2. दस्तावेज़ उल्लेख (Document Mention) की कार्यप्रणाली:**

• लक्ष्य: उपयोगकर्ता को संदेश में दस्तावेज़ का उल्लेख करने की अनुमति देना (जैसे: @report. pdf)।
• दो मुख्य चरण:
• ऑटो-कंप्लीट (Autocomplete): जब उपयोगकर्ता @ टाइप करता है, तो उपलब्ध सभी दस्तावेज़ों की सूची दिखाई देती है।
• कंटेंट इंजेक्शन (Content Injection): संदेश सबमिट होने पर, MCP सर्वर स्वचालित रूप से दस्तावेज़ की सामग्री (Content) प्राप्त करता है और उसे Claude को भेजे जाने वाले प्रॉम्प्ट में शामिल कर देता है।

**3. आवश्यक रिसोर्स प्रकार (Required Resource Types):**

• दस्तावेज़ सूची (List of Documents): ऑटो-कंप्लीट के लिए सभी दस्तावेज़ों के नामों की सूची प्रदान करने हेतु एक रिसोर्स।
• एकल दस्तावेज़ सामग्री (Single Document Content): दस्तावेज़ ID के आधार पर एक विशिष्ट दस्तावेज़ की सामग्री प्राप्त करने हेतु एक रिसोर्स।

**4. रिसोर्स के प्रकार (Types of Resources):**

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

**5. कार्यान्वयन (Implementation Flow):**

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

**6. MIME टाइप (MIME Type) का महत्व:**

• यह क्लाइंट को यह संकेत देता है कि सर्वर किस प्रकार का डेटा लौटा रहा है।
• उदाहरण:
• application/json: जब संरचित (Structured) JSON डेटा लौटाया जाता है।
• text/plain: जब केवल सादा पाठ (Plain Text) लौटाया जाता है (जैसे दस्तावेज़ की सामग्री)।

Takeaways

• MCP सर्वर का मुख्य उद्देश्य क्लाइंट को डेटा एक्सपोज करना है, और प्रत्येक विशिष्ट रीड ऑपरेशन के लिए एक रिसोर्स परिभाषित किया जाता है।
• दस्तावेज़ उल्लेख (जैसे @report. pdf) दो चरणों में काम करता है: ऑटो-कंप्लीट (उपलब्ध दस्तावेज़ों की सूची दिखाना) और कंटेंट इंजेक्शन (संदेश सबमिट होने पर सामग्री को प्रॉम्प्ट में शामिल करना)।
• रिसोर्स दो प्रकार के होते हैं: डायरेक्ट/स्टैटिक (निश्चित URI) और टेम्पलेटेड (URI में पैरामीटर होते हैं, जो अधिक अनुकूलन की अनुमति देते हैं)।
• MIME टाइप यह संकेत देता है कि सर्वर क्लाइंट को किस प्रकार का डेटा लौटा रहा है (उदाहरण के लिए, application/json या text/plain)।