README.md

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

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

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

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

अवलोकन

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

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

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

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

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

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

• C# SDK
• Java SDK
• TypeScript SDK
• Python SDK
• Kotlin SDK

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

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

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

यो रिपोजिटरीमा निम्न भाषाहरूमा नमूना कार्यान्वयनहरू समावेश छन्:

• C#
• Java
• TypeScript
• JavaScript
• Python

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

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

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

स्रोतहरू

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

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

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

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

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

उपकरणहरू

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

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

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

आधिकारिक C# SDK रिपोजिटरीमा MCP का विभिन्न पक्षहरू देखाउने धेरै नमूना कार्यान्वयनहरू छन्:

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

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

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

• C# MCP Nuget ModelContextProtocol

• तपाईंको पहिलो MCP सर्भर निर्माण गर्ने तरिका।

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

API व्यवस्थापन

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

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

Azure नमूना

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

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

उपरोक्त चित्रमा निम्न कार्यहरू हुन्छन्:

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

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

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

MCP अधिकार विनिर्देशन

थप जान्न MCP Authorization specification हेर्नुहोस्।

Azure मा Remote MCP Server तैनाथ गर्ने

अहिले हामीले पहिले उल्लेख गरेको नमूना तैनाथ गर्न सकिन्छ कि सकिँदैन हेर्नुहोस्:

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

   तपाईंले यस्तै इन्टरफेस देख्नुहुनेछ:

   

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

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

4. तपाईंको चलिरहेको API Management SSE अन्तबिन्दु URL सेट गर्नुहोस् जुन azd up पछि देखिन्छ र Connect गर्नुहोस्:

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

5. List Tools। कुनै उपकरणमा क्लिक गरी Run Tool गर्नुहोस्।

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

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

Remote-mcp-functions: यी रिपोजिटरीहरू Azure Functions प्रयोग गरेर Python, C# .NET वा Node/TypeScript मा कस्टम रिमोट MCP सर्भरहरू निर्माण र तैनाथ गर्नका लागि छिटो सुरु गर्ने टेम्प्लेटहरू हुन्।

नमूनाले विकासकर्ताहरूलाई पूर्ण समाधान प्रदान गर्दछ जसले:

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

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

• डिजाइनबाट सुरक्षा: 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 प्रयोग गरी अनुवाद गरिएको हो। हामी शुद्धताका लागि प्रयासरत छौं, तर कृपया ध्यान दिनुहोस् कि स्वचालित अनुवादमा त्रुटि वा अशुद्धता हुन सक्छ। मूल दस्तावेज यसको मूल भाषामा नै अधिकारिक स्रोत मानिनुपर्छ। महत्वपूर्ण जानकारीका लागि व्यावसायिक मानव अनुवाद सिफारिस गरिन्छ। यस अनुवादको प्रयोगबाट उत्पन्न कुनै पनि गलतफहमी वा गलत व्याख्याका लागि हामी जिम्मेवार छैनौं।