README.md

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

(इस पाठ का वीडियो देखने के लिए ऊपर की छवि पर क्लिक करें)

व्यावहारिक कार्यान्वयन वह स्थान है जहाँ मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) की शक्ति महसूस होती है। जबकि MCP के सिद्धांत और वास्तुकला को समझना महत्वपूर्ण है, असली मूल्य तब सामने आता है जब आप इन अवधारणाओं को वास्तविक दुनिया की समस्याओं को हल करने वाले समाधानों को बनाने, परीक्षण करने और डिप्लॉय करने के लिए लागू करते हैं। यह अध्याय वैचारिक ज्ञान और व्यावहारिक विकास के बीच के अंतर को पाटता है, और MCP आधारित अनुप्रयोगों को जीवंत करने की प्रक्रिया में आपका मार्गदर्शन करता है।

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

निम्नलिखित अनुभागों में, आपको व्यावहारिक उदाहरण, नमूना कोड, और डिप्लॉयमेंट रणनीतियाँ मिलेंगी जो यह दिखाती हैं कि C#, Java with Spring, TypeScript, JavaScript, और Python में MCP को कैसे लागू करें। आप यह भी सीखेंगे कि अपने MCP सर्वरों का डिबगीング और परीक्षण कैसे करें, APIs का प्रबंधन कैसे करें, और Azure का उपयोग करके क्लाउड में समाधान कैसे डिप्लॉय करें। ये व्यावहारिक संसाधन आपकी सीखने की प्रक्रिया को तेज़ करने और आपको मजबूत, प्रोडक्शन-तैयार MCP अनुप्रयोग बनाने में आत्मविश्वास देने के लिए डिज़ाइन किए गए हैं।

अवलोकन

यह पाठ कई प्रोग्रामिंग भाषाओं में MCP कार्यान्वयन के व्यावहारिक पहलुओं पर केंद्रित है। हम देखेंगे कि C#, Java with Spring, TypeScript, JavaScript, और Python में MCP SDKs का उपयोग कैसे करें ताकि मजबूत अनुप्रयोग बनाए जा सकें, MCP सर्वरों का डिबगींग और परीक्षण किया जा सके, और पुन: उपयोग योग्य संसाधन, प्रॉम्प्ट, और टूल बनाए जा सकें।

सीखने के उद्देश्य

इस पाठ के अंत तक, आप सक्षम होंगे:

• विभिन्न प्रोग्रामिंग भाषाओं में आधिकारिक SDKs का उपयोग करके MCP समाधान को लागू करना
• MCP सर्वरों का व्यवस्थित रूप से डिबग और परीक्षण करना
• सर्वर फीचर्स (संसाधन, प्रॉम्प्ट, और टूल) बनाना और उपयोग करना
• जटिल कार्यों के लिए प्रभावी MCP वर्कफ़्लोज़ डिज़ाइन करना
• प्रदर्शन और विश्वसनीयता के लिए MCP कार्यान्वयन को अनुकूलित करना

आधिकारिक SDK संसाधन

मॉडल कॉन्टेक्स्ट प्रोटोकॉल कई भाषाओं के लिए आधिकारिक SDKs प्रदान करता है (जो MCP स्पेसिफिकेशन 2025-11-25 के अनुरूप हैं):

• C# SDK
• Java with Spring SDK ध्यान दें: इसके लिए Project Reactor पर निर्भरता आवश्यक है। (देखें चर्चा इश्यू 246.)
• TypeScript SDK
• Python SDK
• Kotlin SDK
• Go SDK

MCP SDKs के साथ काम करना

यह अनुभाग विभिन्न प्रोग्रामिंग भाषाओं में MCP को कार्यान्वित करने के व्यावहारिक उदाहरण प्रदान करता है। आप samples निर्देशिका में भाषा के अनुसार व्यवस्थित नमूना कोड पा सकते हैं।

उपलब्ध नमूने

इस रिपॉजिटरी में निम्नलिखित भाषाओं में नमूना कार्यान्वयन शामिल हैं:

• C#
• Java with Spring
• TypeScript
• JavaScript
• Python

प्रत्येक नमूना उस विशिष्ट भाषा और पारिस्थितिकी तंत्र के लिए प्रमुख MCP अवधारणाएँ और कार्यान्वयन पैटर्न प्रदर्शित करता है।

व्यावहारिक गाइड

MCP कार्यान्वयन के लिए अतिरिक्त गाइड:

• पेजिनेशन और बड़े परिणाम सेट्स - टूल्स, संसाधनों, और बड़े डेटा सेट्स के लिए कर्सर-आधारित पेजिनेशन को संभालना

कोर सर्वर फीचर्स

MCP सर्वर निम्नलिखित फीचर्स में से किसी का भी संयोजन कार्यान्वित कर सकते हैं:

संसाधन

संसाधन उपयोगकर्ता या AI मॉडल के लिए संदर्भ और डेटा प्रदान करते हैं:

• दस्तावेज़ संग्रह
• ज्ञान आधार
• संरचित डेटा स्रोत
• फ़ाइल सिस्टम

प्रॉम्प्ट

प्रॉम्प्ट उपयोगकर्ताओं के लिए टेम्पलेटेड संदेश और वर्कफ़्लोज़ होते हैं:

• पूर्व-परिभाषित संवाद टेम्प्लेट
• मार्गदर्शित इंटरैक्शन पैटर्न
• विशेषीकृत संवाद संरचनाएँ

टूल

टूल AI मॉडल द्वारा निष्पादित फ़ंक्शन होते हैं:

• डेटा प्रोसेसिंग उपयोगिताएँ
• बाहरी API एकीकरण
• गणनात्मक क्षमताएँ
• खोज कार्यक्षमता

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

आधिकारिक C# SDK रिपॉजिटरी में MCP के विभिन्न पहलुओं को प्रदर्शित करने वाले कई नमूना कार्यान्वयन हैं:

• मूल MCP क्लाइंट: MCP क्लाइंट बनाने और टूल कॉल करने का सरल उदाहरण
• मूल MCP सर्वर: बुनियादी टूल पंजीकरण के साथ न्यूनतम सर्वर कार्यान्वयन
• उन्नत MCP सर्वर: टूल पंजीकरण, प्रमाणन, और त्रुटि प्रबंधन के साथ पूर्ण-विशेषता सर्वर
• ASP.NET इंटीग्रेशन: ASP.NET Core के साथ इंटीग्रेशन को दिखाने वाले उदाहरण
• टूल कार्यान्वयन पैटर्न: विभिन्न जटिलता स्तरों के साथ टूल कार्यान्वित करने के लिए विभिन्न पैटर्न

MCP C# SDK प्रीव्यू में है और APIs बदल सकते हैं। SDK विकास के साथ हम इस ब्लॉग को निरंतर अपडेट करते रहेंगे।

प्रमुख विशेषताएँ

• C# MCP Nuget ModelContextProtocol
• आपका पहला MCP सर्वर बनाना।

पूर्ण 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 दृष्टिकोण प्रदान करता है।

प्रमुख विशेषताएँ

• 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 प्राधिकरण विनिर्देशन और जानें।

रिमोट MCP सर्वर Azure पर डिप्लॉय करें

आइए देखें कि क्या हम पहले बताए गए नमूने को डिप्लॉय कर सकते हैं:

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 प्रबंधन सेवा, फंक्शन ऐप (कोड के साथ), और अन्य आवश्यक Azure संसाधन तैयार किए जाएं।

   azd up

   यह कमांड Azure पर सभी क्लाउड संसाधनों को डिप्लॉय कर देगा।

अपने सर्वर का MCP Inspector के साथ परीक्षण करें

1. एक नए टर्मिनल विंडो में MCP Inspector इंस्टॉल और चलाएं

   npx @modelcontextprotocol/inspector

   आपको एक ऐसा इंटरफ़ेस दिखना चाहिए:

   

2. CTRL क्लिक करें और ऐप द्वारा प्रदर्शित URL (जैसे http://127.0.0.1:6274/#resources) से MCP Inspector वेब ऐप लोड करें।

3. ट्रांसपोर्ट प्रकार को SSE सेट करें

4. URL को अपने चल रहे API प्रबंधन SSE एंडपॉइंट पर सेट करें जो azd up के बाद प्रदर्शित होता है और Connect करें:

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

5. टूल सूचीबद्ध करें। किसी टूल पर क्लिक करें और Run Tool करें।

यदि सभी चरण सफलतापूर्वक हुए हैं, तो आप अब MCP सर्वर से जुड़े हुए हैं और आपने एक टूल को कॉल कर लिया है।

Azure के लिए MCP सर्वर

Remote-mcp-functions: यह रिपॉजिटरी सेट Azure Functions के साथ Python, C# .NET या Node/TypeScript का उपयोग करके कस्टम रिमोट MCP (Model Context Protocol) सर्वर बनाने और डिप्लॉय करने के लिए त्वरित आरंभ टेम्पलेट प्रदान करता है।

यह नमूने एक पूर्ण समाधान प्रदान करते हैं जो डेवलपर्स को अनुमति देता है:

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

प्रमुख विशेषताएँ

• डिज़ाइन द्वारा सुरक्षा: MCP सर्वर को कुंजी और HTTPS का उपयोग करके सुरक्षित किया गया है
• प्रमाणीकरण विकल्प: बिल्ट-इन auth और/या API प्रबंधन के साथ 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 SDKs भाषा-विशिष्ट टूल प्रदान करते हैं जो मजबूत MCP समाधान को लागू करने के लिए हैं
• डिबगिंग और परीक्षण प्रक्रिया विश्वसनीय MCP अनुप्रयोगों के लिए महत्वपूर्ण है
• पुन: उपयोग योग्य प्रॉम्प्ट टेम्प्लेट AI इंटरैक्शन को सुसंगत बनाते हैं
• अच्छी डिज़ाइन वाली वर्कफ़्लोज़ कई उपकरणों का उपयोग करके जटिल कार्यों का समन्वय कर सकती हैं
• MCP समाधान को लागू करते समय सुरक्षा, प्रदर्शन और त्रुटि प्रबंधन का ध्यान रखना आवश्यक है

अभ्यास

अपने डोमेन में एक वास्तविक दुनिया की समस्या को संबोधित करने वाला व्यावहारिक MCP वर्कफ़्लो डिज़ाइन करें:

1. ऐसी 3-4 टूल्स पहचानें जो इस समस्या के समाधान के लिए उपयोगी होंगी
2. एक वर्कफ़्लो आरेख बनाएं जो दिखाए कि ये टूल्स कैसे इंटरैक्ट करते हैं
3. अपनी पसंदीदा भाषा का उपयोग करके इन टूल्स में से एक का मूल संस्करण कार्यान्वित करें
4. एक प्रॉम्प्ट टेम्प्लेट बनाएं जो मॉडल को आपके टूल का प्रभावी उपयोग करने में मदद करे

अतिरिक्त संसाधन

---

अगला क्या है

अगला: उन्नत विषय

---

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