Skip to content

Latest commit

 

History

History
281 lines (180 loc) · 28.3 KB

README.md

File metadata and controls

281 lines (180 loc) · 28.3 KB

व्यावहारिक कार्यान्वयन

कसरी वास्तविक उपकरण र कार्यप्रवाहहरू प्रयोग गरेर MCP एप्स निर्माण, परीक्षण, र परिनियोजन गर्ने

(यो पाठको भिडियो हेर्न माथिको चित्रमा क्लिक गर्नुहोस्)

व्यावहारिक कार्यान्वयन भनेको Model Context Protocol (MCP) को शक्ति वास्तविक रूपमा महसुस हुने ठाउँ हो। MCP को सिद्धान्त र वास्तुकलाको बुझाइ महत्त्वपूर्ण भए पनि, यसको वास्तविक मूल्य तब प्रकट हुन्छ जब तपाईं यी अवधारणाहरूलाई प्रयोग गरेर वास्तविक समस्याहरू समाधान गर्ने समाधानहरू निर्माण, परीक्षण, र परिनियोजन गर्नुहुन्छ। यो अध्यायले अवधारणात्मक ज्ञान र व्यावहारिक विकासबीचको खाडललाई पूर्ति गर्दै, MCP-आधारित अनुप्रयोगहरूलाई जीवन्त बनाउने प्रक्रियामा तपाईंलाई मार्गदर्शन गर्दछ।

चाहे तपाईं बुद्धिमान सहायकहरू विकास गर्दै हुनुहुन्छ, AI लाई व्यापार कार्यप्रवाहहरूमा एकीकृत गर्दै हुनुहुन्छ, वा डेटा प्रशोधनका लागि अनुकूल उपकरणहरू निर्माण गर्दै हुनुहुन्छ, MCP ले लचिलो आधार प्रदान गर्दछ। यसको भाषा-स्वतन्त्र डिजाइन र लोकप्रिय प्रोग्रामिङ भाषाहरूका लागि आधिकारिक SDK हरूले यसलाई विभिन्न विकासकर्ताहरूका लागि पहुँचयोग्य बनाउँछ। यी SDK हरूको उपयोग गरेर, तपाईं आफ्नो समाधानहरू विभिन्न प्लेटफर्म र वातावरणहरूमा छिटो प्रोटोटाइप, पुनरावृत्ति, र स्केल गर्न सक्नुहुन्छ।

तलका खण्डहरूमा, तपाईंले व्यावहारिक उदाहरणहरू, नमूना कोड, र परिनियोजन रणनीतिहरू पाउनुहुनेछ जसले C#, Java with Spring, TypeScript, JavaScript, र Python मा MCP कार्यान्वयन कसरी गर्ने भनेर देखाउँछ। तपाईंले MCP सर्भरहरू डिबग र परीक्षण गर्ने, API हरू व्यवस्थापन गर्ने, र Azure प्रयोग गरेर समाधानहरू क्लाउडमा परिनियोजन गर्ने तरिकाहरू पनि सिक्नुहुनेछ। यी व्यावहारिक स्रोतहरूले तपाईंको सिकाइलाई तीव्र बनाउने र तपाईंलाई बलियो, उत्पादन-तयार MCP अनुप्रयोगहरू निर्माण गर्न आत्मविश्वास प्रदान गर्ने उद्देश्य राख्छन्।

अवलोकन

यो पाठले विभिन्न प्रोग्रामिङ भाषाहरूमा MCP कार्यान्वयनका व्यावहारिक पक्षहरूमा केन्द्रित छ। हामी C#, Java with Spring, TypeScript, JavaScript, र Python मा MCP SDK हरू प्रयोग गरेर बलियो अनुप्रयोगहरू निर्माण गर्ने, MCP सर्भरहरू डिबग र परीक्षण गर्ने, र पुन: प्रयोग गर्न मिल्ने स्रोतहरू, प्रॉम्प्टहरू, र उपकरणहरू सिर्जना गर्ने तरिकाहरू अन्वेषण गर्नेछौं।

सिकाइ उद्देश्यहरू

यो पाठको अन्त्यसम्ममा, तपाईंले निम्न गर्न सक्षम हुनुहुनेछ:

  • विभिन्न प्रोग्रामिङ भाषाहरूमा आधिकारिक SDK हरू प्रयोग गरेर MCP समाधानहरू कार्यान्वयन गर्नुहोस्
  • व्यवस्थित रूपमा MCP सर्भरहरू डिबग र परीक्षण गर्नुहोस्
  • सर्भर सुविधाहरू (स्रोतहरू, प्रॉम्प्टहरू, र उपकरणहरू) सिर्जना र प्रयोग गर्नुहोस्
  • जटिल कार्यहरूको लागि प्रभावकारी MCP कार्यप्रवाहहरू डिजाइन गर्नुहोस्
  • प्रदर्शन र विश्वसनीयताका लागि MCP कार्यान्वयनहरू अनुकूलित गर्नुहोस्

आधिकारिक SDK स्रोतहरू

Model Context Protocol ले विभिन्न भाषाहरूका लागि आधिकारिक SDK हरू प्रदान गर्दछ:

MCP SDK हरूसँग काम गर्ने

यस खण्डले विभिन्न प्रोग्रामिङ भाषाहरूमा MCP कार्यान्वयनका व्यावहारिक उदाहरणहरू प्रदान गर्दछ। तपाईंले samples डाइरेक्टरीमा भाषा अनुसार व्यवस्थित नमूना कोड पाउनुहुनेछ।

उपलब्ध नमूनाहरू

भण्डारमा निम्न भाषाहरूमा नमूना कार्यान्वयनहरू समावेश छन्:

प्रत्येक नमूनाले सो भाषाको लागि प्रमुख MCP अवधारणाहरू र कार्यान्वयन ढाँचाहरू प्रदर्शन गर्दछ।

कोर सर्भर सुविधाहरू

MCP सर्भरहरूले यी सुविधाहरूको कुनै पनि संयोजन कार्यान्वयन गर्न सक्छन्:

स्रोतहरू

स्रोतहरूले प्रयोगकर्ता वा AI मोडेलले प्रयोग गर्नका लागि सन्दर्भ र डेटा प्रदान गर्छन्:

  • कागजात भण्डारहरू
  • ज्ञान आधारहरू
  • संरचित डेटा स्रोतहरू
  • फाइल प्रणालीहरू

प्रॉम्प्टहरू

प्रॉम्प्टहरू प्रयोगकर्ताहरूका लागि टेम्प्लेट गरिएको सन्देश र कार्यप्रवाह हुन्:

  • पूर्व-परिभाषित संवाद टेम्प्लेटहरू
  • निर्देशित अन्तरक्रिया ढाँचाहरू
  • विशेष संवाद संरचनाहरू

उपकरणहरू

उपकरणहरू AI मोडेलले कार्यान्वयन गर्नका लागि कार्यहरू हुन्:

  • डेटा प्रशोधन उपयोगिताहरू
  • बाह्य API एकीकरणहरू
  • कम्प्युटेशनल क्षमताहरू
  • खोज कार्यक्षमता

नमूना कार्यान्वयन: C# कार्यान्वयन

आधिकारिक C# SDK भण्डारमा MCP का विभिन्न पक्षहरू प्रदर्शन गर्ने धेरै नमूना कार्यान्वयनहरू समावेश छन्:

  • मूलभूत MCP क्लाइन्ट: MCP क्लाइन्ट सिर्जना गर्ने र उपकरणहरू कल गर्ने सरल उदाहरण
  • मूलभूत MCP सर्भर: आधारभूत उपकरण दर्तासहितको न्यूनतम सर्भर कार्यान्वयन
  • उन्नत MCP सर्भर: उपकरण दर्ता, प्रमाणीकरण, र त्रुटि ह्यान्डलिङसहितको पूर्ण-विशेषतायुक्त सर्भर
  • ASP.NET एकीकरण: ASP.NET Core सँग एकीकरण प्रदर्शन गर्ने उदाहरणहरू
  • उपकरण कार्यान्वयन ढाँचाहरू: विभिन्न जटिलता स्तरहरूसँग उपकरण कार्यान्वयनका लागि विभिन्न ढाँचाहरू

C# MCP SDK पूर्वावलोकनमा छ र API हरू परिवर्तन हुन सक्छ। SDK विकसित हुँदै जाँदा हामी यो ब्लग निरन्तर अद्यावधिक गर्नेछौं।

प्रमुख सुविधाहरू

C# कार्यान्वयनका सम्पूर्ण नमूनाहरूका लागि, आधिकारिक C# SDK नमूना भण्डार भ्रमण गर्नुहोस्।

नमूना कार्यान्वयन: Java with Spring कार्यान्वयन

Java with Spring SDK ले उद्यम-स्तरका सुविधाहरूका साथ बलियो MCP कार्यान्वयन विकल्पहरू प्रदान गर्दछ।

प्रमुख सुविधाहरू

  • Spring Framework एकीकरण
  • बलियो प्रकार सुरक्षा
  • प्रतिक्रियात्मक प्रोग्रामिङ समर्थन
  • व्यापक त्रुटि ह्यान्डलिङ

Java with Spring कार्यान्वयनको सम्पूर्ण नमूनाका लागि, नमूना डाइरेक्टरीमा Java with Spring नमूना हेर्नुहोस्।

नमूना कार्यान्वयन: JavaScript कार्यान्वयन

JavaScript SDK ले हल्का र लचिलो MCP कार्यान्वयन दृष्टिकोण प्रदान गर्दछ।

प्रमुख सुविधाहरू

  • Node.js र ब्राउजर समर्थन
  • प्रतिज्ञा-आधारित API
  • Express र अन्य फ्रेमवर्कहरूसँग सजिलो एकीकरण
  • स्ट्रिमिङका लागि WebSocket समर्थन

JavaScript कार्यान्वयनको सम्पूर्ण नमूनाका लागि, नमूना डाइरेक्टरीमा JavaScript नमूना हेर्नुहोस्।

नमूना कार्यान्वयन: Python कार्यान्वयन

Python SDK ले उत्कृष्ट ML फ्रेमवर्क एकीकरणहरूसँग Pythonic MCP कार्यान्वयन दृष्टिकोण प्रदान गर्दछ।

प्रमुख सुविधाहरू

  • asyncio सँग Async/await समर्थन
  • FastAPI एकीकरण
  • सरल उपकरण दर्ता
  • लोकप्रिय ML पुस्तकालयहरूसँग देशीय एकीकरण

Python कार्यान्वयनको सम्पूर्ण नमूनाका लागि, नमूना डाइरेक्टरीमा Python नमूना हेर्नुहोस्।

API व्यवस्थापन

Azure API Management MCP सर्भरहरूलाई कसरी सुरक्षित गर्न सकिन्छ भन्ने उत्कृष्ट उत्तर हो। विचार भनेको तपाईंको MCP सर्भरको अगाडि Azure API Management इन्स्ट्यान्स राख्नु हो र यसले तपाईंलाई चाहिने सम्भावित सुविधाहरू जस्तै:

  • दर सीमितता
  • टोकन व्यवस्थापन
  • अनुगमन
  • लोड ब्यालेन्सिङ
  • सुरक्षा

Azure नमूना

यहाँ एक Azure नमूना छ, जसले ठीक यही गर्छ, अर्थात् MCP सर्भर सिर्जना गर्ने र यसलाई Azure API Management सँग सुरक्षित गर्ने।

तलको चित्रमा प्राधिकरण प्रवाह कसरी हुन्छ हेर्नुहोस्:

APIM-MCP

माथिको चित्रमा, निम्न हुन्छ:

  • प्रमाणीकरण/प्राधिकरण Microsoft Entra प्रयोग गरेर हुन्छ।
  • Azure API Management गेटवेको रूपमा कार्य गर्दछ र ट्राफिक निर्देशन र व्यवस्थापन गर्न नीतिहरू प्रयोग गर्दछ।
  • Azure Monitor ले थप विश्लेषणका लागि सबै अनुरोधहरू लग गर्दछ।

प्राधिकरण प्रवाह

प्राधिकरण प्रवाहलाई थप विवरणमा हेरौं:

क्रम रेखाचित्र

MCP प्राधिकरण विशिष्टता

MCP प्राधिकरण विशिष्टता को बारेमा थप जान्नुहोस्।

Azure मा रिमोट MCP सर्भर परिनियोजन गर्नुहोस्

हेरौं कि हामीले पहिले उल्लेख गरेको नमूना परिनियोजन गर्न सक्छौं कि सक्दैनौं:

  1. रिपो क्लोन गर्नुहोस्

    git clone https://github.com/Azure-Samples/remote-mcp-apim-functions-python.git
cd remote-mcp-apim-functions-python

  2. Microsoft.App स्रोत प्रदायक दर्ता गर्नुहोस्।

    • यदि तपाईं Azure CLI प्रयोग गर्दै हुनुहुन्छ भने, az provider register --namespace Microsoft.App --wait चलाउनुहोस्।
    • यदि तपाईं Azure PowerShell प्रयोग गर्दै हुनुहुन्छ भने, Register-AzResourceProvider -ProviderNamespace Microsoft.App चलाउनुहोस्। त्यसपछि केही समयपछि (Get-AzResourceProvider -ProviderNamespace Microsoft.App).RegistrationState चलाएर दर्ता पूरा भएको छ कि छैन जाँच गर्नुहोस्।

  3. यो azd आदेश चलाउनुहोस् जसले api management सेवा, function app (कोडसहित) र अन्य आवश्यक Azure स्रोतहरू प्रावधान गर्दछ

    azd up

    यस आदेशले Azure मा सबै क्लाउड स्रोतहरू परिनियोजन गर्नुपर्छ।

MCP Inspector प्रयोग गरेर आफ्नो सर्भर परीक्षण गर्नुहोस्

  1. नयाँ टर्मिनल विन्डो मा, MCP Inspector स्थापना र चलाउनुहोस्

    npx @modelcontextprotocol/inspector

    तपाईंले निम्न जस्तो इन्टरफेस देख्नुहुनेछ:

    Node Inspector मा जडान गर्नुहोस्

  2. URL मा देखाइएको URL (जस्तै http://127.0.0.1:6274/#resources) बाट MCP Inspector वेब एप लोड गर्न CTRL क्लिक गर्नुहोस्।

  3. ट्रान्सपोर्ट प्रकारलाई SSE मा सेट गर्नुहोस्।

  4. azd up पछि देखाइएको आफ्नो चलिरहेको API Management SSE अन्त बिन्दुमा URL सेट गर्नुहोस् र जडान गर्नुहोस्:

    https://<apim-servicename-from-azd-output>.azure-api.net/mcp/sse

  5. उपकरण सूचीबद्ध गर्नुहोस्। कुनै उपकरणमा क्लिक गर्नुहोस् र उपकरण चलाउनुहोस्।

यदि सबै चरणहरू सफल भए, तपाईं अब MCP सर्भरसँग जडान हुनुहुन्छ र उपकरण कल गर्न सक्षम हुनुहुन्छ।

Azure का लागि MCP सर्भरहरू

Remote-mcp-functions: यी भण्डारहरूको सेटले Python, C# .NET वा Node/TypeScript प्रयोग गरेर Azure Functions मार्फत अनुकूल रिमोट MCP (Model Context Protocol) सर्भरहरू निर्माण र परिनियोजन गर्नका लागि क्विकस्टार्ट टेम्प्लेट प्रदान गर्दछ।

नमूनाहरूले विकासकर्ताहरूलाई निम्न गर्न अनुमति दिन्छ:

  • स्थानीय रूपमा निर्माण र चलाउनुहोस्: स्थानीय मेसिनमा MCP सर्भर विकास र डिबग गर्नुहोस्।
  • Azure मा परिनियोजन गर्नुहोस्: साधारण azd up आदेशको साथ क्लाउडमा सजिलै परिनियोजन गर्नुहोस्।
  • क्लाइन्टहरूबाट जडान गर्नुहोस्: VS Code को Copilot एजेन्ट मोड र MCP Inspector उपकरण सहित विभिन्न क्लाइन्टहरूबाट MCP सर्भरसँग जडान गर्नुहोस्।

प्रमुख सुविधाहरू

  • डिजाइनद्वारा सुरक्षा: MCP सर्भर कुञ्जीहरू र HTTPS प्रयोग गरेर सुरक्षित छ।
  • प्रमाणीकरण विकल्पहरू: निर्मित प्रमाणीकरण र/वा API Management प्रयोग गरेर OAuth समर्थन गर्दछ।
  • नेटवर्क अलगाव: Azure Virtual Networks (VNET) प्रयोग गरेर नेटवर्क अलगाव अनुमति दिन्छ।
  • सर्भरलेस वास्तुकला: स्केलेबल, घटना-चालित कार्यान्वयनका लागि Azure Functions प्रयोग गर्दछ।
  • स्थानीय विकास: व्यापक स्थानीय विकास र डिबग समर्थन।
  • सरल परिनियोजन: Azure मा परिनियोजन प्रक्रिया सरल।

भण्डारमा उत्पादन-तयार MCP सर्भर कार्यान्वयनको लागि छिटो सुरु गर्न आवश्यक सबै कन्फिगरेसन फाइलहरू, स्रोत कोड, र पूर्वाधार परिभाषाहरू समावेश छन्।

  • Azure Remote MCP Functions Python - Python प्रयोग गरेर Azure Functions को साथ MCP को नमूना कार्यान्वयन।
  • Azure Remote MCP Functions .NET - C# .NET प्रयोग गरेर Azure Functions को साथ MCP को नमूना कार्यान्वयन।
  • Azure Remote MCP Functions Node/Typescript - Node/TypeScript प्रयोग गरेर Azure Functions को साथ MCP को नमूना कार्यान्वयन।

प्रमुख निष्कर्षहरू

  • MCP SDK हरूले बलियो MCP समाधानहरू कार्यान्वयन गर्न भाषा-विशिष्ट उपकरणहरू प्रदान गर्दछ।
  • डिबग र परीक्षण प्रक्रिया विश्वसनीय MCP अनुप्रयोगहरूको लागि महत्त्वपूर्ण छ।
  • पुन: प्रयोग गर्न मिल्ने प्रॉम्प्ट टेम्प्लेटहरूले स्थिर AI अन्तरक्रियाहरू सक्षम बनाउँछन्।
  • राम्रोसँग डिजाइन गरिएका कार्यप्रवाहहरूले धेरै उपकरणहरू प्रयोग गरेर जटिल कार्यहरू समन्वय गर्न सक्छन्।
  • MCP समाधानहरू कार्यान्वयन गर्दा सुरक्षा, प्रदर्शन, र त्रुटि ह्यान्डलिङको विचार गर्न आवश्यक छ।

अभ्यास

आफ्नो डोमेनमा वास्तविक-विश्व समस्यालाई सम्बोधन गर्ने व्यावहारिक MCP कार्यप्रवाह डिजाइन गर्नुहोस्:

  1. यो समस्या समाधान गर्न उपयोगी हुने ३-४ उपकरणहरू पहिचान गर्नुहोस्।
  2. यी उपकरणहरू कसरी अन्तरक्रिया गर्छन् भन्ने देखाउने कार्यप्रवाह आरेख सिर्जना गर्नुहोस्।
  3. आफ्नो मनपर्ने भाषाको प्रयोग गरेर ती उपकरणहरूमध्ये एकको आधारभूत संस्करण कार्यान्वयन गर्नुहोस्।
  4. तपाईंको उपकरणलाई प्रभावकारी रूपमा प्रयोग गर्न मोडेललाई मद्दत गर्ने प्रॉम्प्ट टेम्प्लेट सिर्जना गर्नुहोस्।

थप स्रोतहरू

अर्को: उन्नत विषयहरू

अस्वीकरण:
यो दस्तावेज़ AI अनुवाद सेवा Co-op Translator प्रयोग गरेर अनुवाद गरिएको छ। हामी शुद्धताको लागि प्रयास गर्छौं, तर कृपया ध्यान दिनुहोस् कि स्वचालित अनुवादहरूमा त्रुटिहरू वा अशुद्धताहरू हुन सक्छ। यसको मूल भाषा मा रहेको मूल दस्तावेज़लाई आधिकारिक स्रोत मानिनुपर्छ। महत्वपूर्ण जानकारीको लागि, व्यावसायिक मानव अनुवाद सिफारिस गरिन्छ। यस अनुवादको प्रयोगबाट उत्पन्न हुने कुनै पनि गलतफहमी वा गलत व्याख्याको लागि हामी जिम्मेवार हुने छैनौं।