MCP (Model Context Protocol) पर tools
जैसे ही आपके ऐप में एक से ज़्यादा tool हों, हर मॉडल विक्रेता उन्हें बुलाने का अपना JSON आकार गढ़ता है, और आप हर प्रदाता के लिए एक adapter लिखते रह जाते हैं। Model Context Protocol (MCP) वह खुला मानक है जो इसे ठीक करता है। यह किसी भी मॉडल client को tools (फ़ंक्शन जिन्हें मॉडल बुला सकता है), resources (डेटा जिसे वह पढ़ सकता है), और prompts दिखाने के लिए एक JSON-RPC 2.0 wire protocol है। एक MCP server एक बार लिखें और कोई भी MCP समझने वाला client (एक IDE सहायक, एक desktop ऐप, एक agent) उसे इस्तेमाल कर सकता है।
हर संदेश JSON-RPC 2.0 है, जो एक छोटा, तय लिफ़ाफ़ा है। एक request हमेशा चार कुंजियाँ रखती है:
{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
"params": {"name": "add", "arguments": {"a": 2, "b": 3}}}id जवाब को उसकी request से जोड़ता है। server एक response से जवाब देता है जो वही id दोहराता है और या तो एक result या एक error ऑब्जेक्ट रखता है, दोनों कभी नहीं:
{"jsonrpc": "2.0", "id": 1, "result": {"content": [{"type": "text", "text": "5"}], "isError": false}}
{"jsonrpc": "2.0", "id": 1, "error": {"code": -32601, "message": "Method not found"}}ऋणात्मक codes मानक JSON-RPC हैं: -32601 "method not found" है, -32602 "invalid params" है, वग़ैरह। एक tools/call नतीजे का हमेशा वह आकार होता है: blocks (टेक्स्ट, तस्वीरें, वग़ैरह) की एक content सूची और साथ में isError। जो tool चला पर विफल हुआ (मान लें ख़राब शहर का नाम) वह सामान्य नतीजे में isError: true से जवाब देता है, ताकि मॉडल विफलता पढ़ सके; JSON-RPC error ऑब्जेक्ट अनजान method जैसी protocol समस्याओं के लिए है।
एक सत्र एक handshake से शुरू होता है: client एक initialize request भेजता है (उसका protocol वर्ज़न, उसकी क्षमताएँ और उसका नाम), server अपनी क्षमताओं से जवाब देता है, और client एक notifications/initialized notification से पुष्टि करता है (बिना id वाला संदेश, क्योंकि उसका कोई जवाब नहीं देता)। उसके बाद ही client ख़ाली params के साथ tools/list बुलाकर tools खोजता है; server tool विवरणों की सूची लौटाता है।
एक असली MCP server stdio या HTTP पर चलता है और इसे SDK में जोड़ता है; यहाँ हम मानक library के json मॉड्यूल से संदेश बनाते और parse करते हैं ताकि wire format ठोस हो। आप तीन फ़ंक्शन लिख रहे हैं।
build_request(id, method, params)-> लिफ़ाफ़े{"jsonrpc": "2.0", "id": id, "method": method, "params": params}के लिए एक JSON स्ट्रिंग।json.dumpsइस्तेमाल करें।parse_response(text)-> टेक्स्ट कोjson.loadsकरें,jsonrpc == "2.0"ज़रूरी करें (नहीं तोValueErrorउठाएँ)। अगर इसमेंresultहै, तो{"id": ..., "ok": True, "result": ...}लौटाएँ। अगर इसमेंerrorहै, तो{"id": ..., "ok": False, "error": {"code": ..., "message": ...}}लौटाएँ। अगर दोनों में से कुछ नहीं, तोValueErrorउठाएँ।list_tools_request(id)-> tool-खोज request: method"tools/list"और ख़ालीparams{}वाला एकbuild_request।
क्योंकि build_request एक स्ट्रिंग लौटाता है, टेस्ट उसे json.loads से वापस parse करते हैं और dict की तुलना करते हैं, इसलिए कुंजियों का क्रम मायने नहीं रखता। पक्का करें कि result और error दोनों आना-जाना कर सकें, खोज request का method सही हो, और jsonrpc से ख़ाली या result और error दोनों से ख़ाली संदेश error उठाए।
json मॉड्यूल से MCP-शैली के JSON-RPC 2.0 संदेश बनाएँ और parse करें। build_request(id, method, params) {"jsonrpc": "2.0", "id", "method", "params"} की JSON स्ट्रिंग लौटाता है। parse_response(text) टेक्स्ट load करता है, jsonrpc == "2.0" ज़रूरी करता है (नहीं तो ValueError उठाएँ), और result के लिए {"id", "ok": True, "result"} या error के लिए {"id", "ok": False, "error": {"code", "message"}} लौटाता है, दोनों में से कुछ न होने पर error उठाते हुए। list_tools_request(id) ख़ाली params के साथ tools/list खोज request लौटाता है (handshake के बाद भेजी जाती है)।
इस पाठ में कोई समस्या दिखी? बताएँ · इस पाठ के बारे में पूछें
यह अभ्यास जल्द खुलेगा
इससे पहले वाला पाठ पूरा करें और यह खुल जाएगा। पूरा कोर्स मुफ़्त है, कोई खाता नहीं चाहिए, और आप यह पाठ अभी पढ़ सकते हैं।
यह ब्राउज़र learn.floati.life के लिए कुकी रोक रहा है, इसलिए यहाँ पूरे किए गए पाठ क्रम से नहीं खुल सकते। इस साइट के लिए कुकी की अनुमति दें और फिर से लोड करें।