Implementing a client

MCP क्लाइंट (MCP Client) के मुख्य अध्ययन बिंदु

• प्रोजेक्ट आर्किटेक्चर: इस प्रोजेक्ट में क्लाइंट और सर्वर दोनों को लागू किया गया है।
• MCP क्लाइंट की संरचना:
• MCP क्लाइंट एक क्लास है जो 'क्लाइंट सेशन' (Client Session) को रैप (wrap) करता है।
• क्लाइंट सेशन ही MCP सर्वर के साथ वास्तविक कनेक्शन स्थापित करता है (यह MCP Python SDK का हिस्सा है)।
• क्लाइंट क्लास का उद्देश्य:
• यह क्लास सर्वर से कनेक्शन के दौरान आवश्यक रिसोर्स मैनेजमेंट और क्लीनअप (cleanup) को आसान बनाती है।
• क्लाइंट की कार्यक्षमता सर्वर की क्षमताओं को बाकी कोडबेस के लिए उजागर (expose) करती है।
• मुख्य कार्य (Core Functions):
• list tools: सर्वर द्वारा परिभाषित सभी उपलब्ध टूल्स की सूची प्राप्त करने के लिए उपयोग किया जाता है।
• call tool: क्लाउड (Claude) द्वारा अनुरोधित विशिष्ट टूल को चलाने के लिए उपयोग किया जाता है।
• कार्यप्रणाली:
• list tools → await self. session. list_tools() को कॉल करता है।
• call tool → await self. session. call_tool(tool_name, tool_input) को कॉल करता है।
• महत्वपूर्ण ध्यान देने योग्य बात (Gotcha):
• MCP स्पेसिफिकेशन (Spec) में टूल की परिभाषा का स्ट्रक्चर Bedrock JSON स्कीमा से थोड़ा अलग होता है।
• इसलिए, कोड के भीतर इस टूल परिभाषा को Bedrock द्वारा अपेक्षित सटीक स्ट्रक्चर में रूपांतरित (convert) करना आवश्यक होता है (यह प्रक्रिया कोड में स्वचालित रूप से की जाती है)।
• अंतिम लक्ष्य: क्लाइंट का उपयोग करके सर्वर की क्षमताओं (जैसे दस्तावेज़ पढ़ना या संपादित करना) को क्लाउड (Claude) के साथ एकीकृत करना।

Takeaways

• MCP क्लाइंट एक क्लास है जो 'क्लाइंट सेशन' को रैप करता है और सर्वर के साथ कनेक्शन तथा रिसोर्स मैनेजमेंट को संभालता है।
• इसके दो मुख्य कार्य हैं: list tools (उपलब्ध टूल्स की सूची प्राप्त करना) और call tool (अनुरोधित विशिष्ट टूल को चलाना)।
• टूल परिभाषा का स्ट्रक्चर Bedrock JSON स्कीमा से अलग होता है, इसलिए कोड के भीतर इस परिभाषा को अपेक्षित स्ट्रक्चर में रूपांतरित करना आवश्यक है।
• क्लाइंट का अंतिम लक्ष्य सर्वर की क्षमताओं (जैसे दस्तावेज़ पढ़ना) को क्लाउड (Claude) के साथ एकीकृत करना है।