पाठ्यक्रम 250 में से पाठ 139 · संरचित आउटपुट और function/tool calling
संरचित आउटपुट और function/tool calling

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 के बाद भेजी जाती है)।

इस पाठ में कोई समस्या दिखी? बताएँ · इस पाठ के बारे में पूछें

यह अभ्यास जल्द खुलेगा

इससे पहले वाला पाठ पूरा करें और यह खुल जाएगा। पूरा कोर्स मुफ़्त है, कोई खाता नहीं चाहिए, और आप यह पाठ अभी पढ़ सकते हैं।