ADK-Rust में मॉडल संदर्भ प्रोटोकॉल
मॉडल संदर्भ प्रोटोकॉल (MCP) एक AI अनुप्रयोग और अलग स्वामित्व वाली क्षमता के बीच की सीमा है। एक MCP सर्वर उपकरण, पढ़ने योग्य संसाधन, प्रॉम्प्ट टेम्पलेट और तर्क पूर्णता प्रकाशित कर सकता है। क्लाइंट उस कैटलॉग की खोज करता है और निजी एकीकरण के बजाय सहमत प्रोटोकॉल विधियों के माध्यम से संचार करता है।
ADK-Rust 2 आधिकारिक rmcp 3.1 SDK का उपयोग करता है। क्लाइंट डिफ़ॉल्ट रूप से
MCP 2025-11-25 पर बातचीत करता है और पुराने हैंडशेक के माध्यम से
2026-07-28 सर्वरों तक पहुँचता है। rmcp संगतता देखें।
ADK-Rust कहाँ फिट होता है
McpToolset एक प्रारंभित MCP क्लाइंट कनेक्शन को ADK-Rust के अनुकूल बनाता है।
McpServerManager स्थानीय stdio चाइल्ड प्रक्रियाओं की बदलती रजिस्ट्री का स्वामित्व रखता है और
उनके उपकरणों को एकत्रित करता है। क्षमताएँ प्रकाशित करने वाले अनुप्रयोग
adk_tool::mcp::rmcp के साथ MCP सर्वर बना सकते हैं, जो फ़्रेमवर्क द्वारा उपयोग किया जाने वाला
सटीक SDK संस्करण है।
सही इंटरफ़ेस चुनें
| आपको यह करना है | उपयोग करें | स्वामित्व |
|---|---|---|
| एक ज्ञात स्थानीय सर्वर से कनेक्ट करें | McpToolset + TokioChildProcess | एप्लिकेशन चाइल्ड प्रक्रिया शुरू करता है |
| एक रिमोट MCP सेवा से कनेक्ट करें | McpHttpClientBuilder | रिमोट डिप्लॉयमेंट उपलब्धता का स्वामी है |
| रनटाइम पर स्थानीय सर्वर परिभाषाएँ बदलें | McpServerManager | एप्लिकेशन के पास स्थानीय रजिस्ट्री और चाइल्ड प्रक्रियाएँ हैं |
| एक MCP सर्वर प्रकाशित करें | adk_tool::mcp::rmcp | आपकी सेवा के पास स्कीमा, प्राधिकरण और साइड इफ़ेक्ट्स का स्वामित्व है |
| अप्रचलित सैंपलिंग इंटीग्रेशन को कार्यशील बनाए रखें | mcp-sampling सुविधा | केवल SEP-2577 के अंतर्गत संगतता |
कार्यान्वित क्षमता मानचित्र
| क्षमता | ADK-Rust API | व्यवहार |
|---|---|---|
| टूल की खोज और कॉल | McpToolset, Toolset | कच्चे स्कीमा और बहु-माध्यमीय परिणाम संरक्षित रहते हैं |
| टूल फ़िल्टर करना | with_filter, with_tools | मॉडल केवल चयनित टूल देखता है |
| संसाधन और टेम्पलेट | list_resources, list_resource_templates, read_resource | स्थिर URIs के माध्यम से संदर्भ पढ़ें |
| प्रॉम्प्ट | list_prompts, get_prompt | पुनः उपयोग योग्य सर्वर-स्वामित्व वाले संदेशों का समाधान करें |
| पूर्णता | complete_prompt_argument, complete_resource_argument | सर्वर से तर्क सुझाव माँगें |
| संसाधन सदस्यताएँ | subscribe_resource, unsubscribe_resource | कस्टम हैंडलर अद्यतन सूचनाएँ प्राप्त करते हैं |
| जानकारी-प्राप्ति | ElicitationHandler | फ़ॉर्म और URL मोड |
| कार्य | McpTaskConfig | सहमत टूल-कॉल कार्य निर्माण, पोलिंग, परिणाम और रद्दीकरण |
| स्ट्रीम करने योग्य HTTP | McpHttpClientBuilder | टाइमआउट, हेडर, ऑथ इंजेक्शन, समाप्त-सत्र पुनर्प्राप्ति |
| डायनेमिक स्थानीय रजिस्ट्री | McpServerManager | जोड़ना, अपडेट करना, सक्षम करना, अक्षम करना, हटाना, सहेजना, मॉनिटर करना और पुनः आरंभ करना |
| उन्नत SDK कार्य | adk_tool::mcp::rmcp | सर्वर हैंडलर, ट्रांसपोर्ट, सूचनाएँ और एक्सटेंशन प्रकार |
दस्तावेज़ीकरण पथ
- MCP क्लाइंट बनाएँ
- स्थानीय MCP सर्वरों का गतिशील रूप से प्रबंधन करें
- MCP सर्वर प्रकाशित करें
- सुरक्षा और प्राधिकरण
- परीक्षण और सत्यापन
- प्रदाता-जागरूक स्कीमा सामान्यीकरण
महत्वपूर्ण सीमाएँ
- गतिशील प्रबंधन वर्तमान में स्थानीय stdio चाइल्ड प्रक्रियाओं को लक्षित करता है।
- प्रबंधक का स्वास्थ्य निगरानी तंत्र बंद हो चुके MCP कनेक्शन का पता लगाता है। यह यह प्रमाणित नहीं करता कि सर्वर का डेटाबेस या बाहरी API स्वस्थ है।
- संगत कॉन्फ़िगरेशन के लिए
autoApproveको संरक्षित रखा गया है; ADK-Rust इसे प्राधिकरण के रूप में व्याख्यायित नहीं करता। OAuth2Configएक निश्चित client-credentials टोकन अनुरोध करता है। यह पूर्ण MCP प्राधिकरण खोज और ब्राउज़र-प्राधिकरण प्रवाह नहीं है।- SEP-2577 के माध्यम से upstream में सैंपलिंग, रूट्स और लॉगिंग को अप्रचलित घोषित किया गया है।
ये सीमाएँ सार्वजनिक अनुबंध का हिस्सा हैं और इन्हें परिनियोजन डिज़ाइन में प्रतिबिंबित किया जाना चाहिए।