MCPClient किसी भी MCP सर्वर के साथ इंटरैक्ट करने के लिए एक async Python Client है। यह MCP हैंडशेक (initialize), ट्रांसपोर्ट सेटअप और सेशन प्रबंधन संभालता है—ताकि आप जिन ऑपरेशनों को चलाना चाहते हैं, उन पर फोकस कर सकें।
MCPClient का उपयोग तब करें जब आप स्पष्ट, पूर्वानुमानित नियंत्रण चाहते हैं, जैसे:
- डेवलपमेंट के दौरान MCP सर्वर का परीक्षण करना
- ऐसी एप्लिकेशन बनाना जिन्हें विश्वसनीय MCP इंटरैक्शन चाहिए
- टाइप्ड प्रोटोकॉल लेयर के ऊपर हायर-लेवल Clients (जिनमें एजेंट‑आधारित फ्लो शामिल हैं) बनाना
## त्वरित प्रारंभ
कनेक्ट करें → काम करें → कनेक्शन बंद करें।
async with को प्राथमिकता दें:
## Connection
### कनेक्ट करें
### प्रोटोकॉल जानकारी
कनेक्ट होने के बाद, initialize_result भर दिया जाता है:
### कनेक्शन बंद करना
### वैकल्पिक तरीका:
open_connection(...)open_connection(...) एक सुविधाजनक रैपर है जो एक कनेक्टेड MCPClient उपलब्ध कराता है और अपने‑आप क्लीन‑अप कर देता है:
### पिंग
## ऑपरेशंस
अधिकांश Client कोड निम्न में से किसी एक श्रेणी में आता है:
टूल्स
सर्वर-साइड फ़ंक्शन्स की सूची देखें और उन्हें कॉल करें
संसाधन
डेटा सोर्सेज़ की सूची देखें और उन्हें पढ़ें
Prompts
संदेश टेम्पलेट्स की सूची देखें और उन्हें प्राप्त करें
## Client क्षमताएँ (server → client)
कुछ मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) सुविधाएँ सर्वर द्वारा आरंभ की जाती हैं। यदि आप इन्हें सपोर्ट करना चाहते हैं, तो कनेक्ट करते समय इनके लिए हैंडलर कॉन्फ़िगर करते हैं।
सैंपलिंग
सर्वर से आने वाले LLM completion अनुरोधों को हैंडल करें
एलिसिटेशन
tool execution के दौरान उपयोगकर्ता इनपुट एकत्र करें
रूट्स
सर्वर को फ़ाइल सिस्टम की सीमाओं के बारे में बताएं
लॉगिंग
सर्वर से लॉग संदेश प्राप्त करें
## प्रमाणीकरण
सुरक्षित MCP सर्वरों के लिए:
Bearer Auth
API कुंजियाँ और सर्विस टोकन
OAuth
ब्राउज़र फ्लो के माध्यम से उपयोगकर्ता सहमति और प्रतिनिधित एक्सेस
### DPoP प्रमाणीकरण
DPoP (RFC 9449) प्रेषक-सीमित (sender-constrained) टोकन का उपयोग करने वाले सर्वरों के लिए: