README.md

व्यावहारिक अंमलबजावणी

व्यावहारिक अंमलबजावणी म्हणजे Model Context Protocol (MCP) ची शक्ती प्रत्यक्षात जाणवते. MCP च्या सिद्धांत आणि आर्किटेक्चर समजून घेणे महत्त्वाचे असले तरी, खरी किंमत तेव्हा दिसून येते जेव्हा तुम्ही या संकल्पनांचा वापर करून वास्तविक समस्या सोडवणाऱ्या उपायांची रचना, चाचणी आणि तैनाती करता. हा अध्याय संकल्पनात्मक ज्ञान आणि प्रत्यक्ष विकास यामधील अंतर कमी करतो आणि तुम्हाला MCP-आधारित अनुप्रयोग तयार करण्याच्या प्रक्रियेत मार्गदर्शन करतो.

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

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

आढावा

हा धडा MCP अंमलबजावणीच्या व्यावहारिक पैलूंवर लक्ष केंद्रित करतो, अनेक प्रोग्रामिंग भाषांमध्ये. आपण C#, Java, TypeScript, JavaScript आणि Python मध्ये MCP SDKs कसे वापरायचे, MCP सर्व्हर डिबग आणि चाचणी कशी करायची, तसेच पुनर्वापरयोग्य संसाधने, प्रॉम्प्ट्स आणि साधने कशी तयार करायची हे पाहू.

शिकण्याचे उद्दिष्टे

या धड्याच्या शेवटी, तुम्ही सक्षम असाल:

• विविध प्रोग्रामिंग भाषांमध्ये अधिकृत SDKs वापरून MCP उपाय अंमलात आणणे
• MCP सर्व्हरची प्रणालीबद्ध डिबगिंग आणि चाचणी करणे
• सर्व्हर वैशिष्ट्ये (Resources, Prompts, आणि Tools) तयार करणे आणि वापरणे
• गुंतागुंतीच्या कामांसाठी प्रभावी MCP वर्कफ्लोज डिझाइन करणे
• कार्यक्षमता आणि विश्वासार्हतेसाठी MCP अंमलबजावणीचे ऑप्टिमायझेशन करणे

अधिकृत SDK संसाधने

Model Context Protocol अनेक भाषांसाठी अधिकृत SDKs प्रदान करतो:

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

MCP SDKs सह काम करणे

हा विभाग अनेक प्रोग्रामिंग भाषांमध्ये MCP अंमलबजावणीचे व्यावहारिक उदाहरणे प्रदान करतो. तुम्हाला samples निर्देशिकेत भाषेनुसार आयोजित नमुना कोड सापडेल.

उपलब्ध नमुने

रिपॉझिटरीमध्ये खालील भाषांमध्ये नमुना अंमलबजावणी समाविष्ट आहे:

• C#
• Java
• TypeScript
• JavaScript
• Python

प्रत्येक नमुन्यात त्या विशिष्ट भाषा आणि परिसंस्थेसाठी MCP च्या मुख्य संकल्पना आणि अंमलबजावणी पद्धती दाखवल्या आहेत.

मुख्य सर्व्हर वैशिष्ट्ये

MCP सर्व्हर खालील कोणत्याही वैशिष्ट्यांचे संयोजन अंमलात आणू शकतात:

Resources

Resources वापरकर्त्यास किंवा AI मॉडेलला संदर्भ आणि डेटा पुरवतात:

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

Prompts

Prompts वापरकर्त्यांसाठी टेम्प्लेटेड संदेश आणि वर्कफ्लोज असतात:

• पूर्वनिर्धारित संभाषण टेम्प्लेट
• मार्गदर्शित संवाद नमुने
• विशेष संवाद रचना

Tools

Tools AI मॉडेलसाठी कार्ये पार पाडण्यासाठी असतात:

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

नमुना अंमलबजावणी: C#

अधिकृत C# SDK रिपॉझिटरीमध्ये MCP च्या विविध पैलू दाखवणाऱ्या अनेक नमुना अंमलबजावण्या आहेत:

• Basic MCP Client: MCP क्लायंट तयार करून साधे टूल कॉल कसे करायचे हे दाखवणारे उदाहरण
• Basic MCP Server: मूलभूत टूल नोंदणीसह किमान सर्व्हर अंमलबजावणी
• Advanced MCP Server: टूल नोंदणी, प्रमाणीकरण आणि त्रुटी हाताळणीसह पूर्ण वैशिष्ट्यांचा सर्व्हर
• ASP.NET Integration: ASP.NET Core सह समाकलन दाखवणारे उदाहरणे
• Tool Implementation Patterns: विविध जटिलतेच्या टूल्ससाठी अंमलबजावणी पद्धती

MCP C# SDK अजून प्रीव्ह्यूमध्ये आहे आणि API मध्ये बदल होऊ शकतात. SDK विकसित होत असताना आम्ही हा ब्लॉग सतत अपडेट करू.

मुख्य वैशिष्ट्ये

• C# MCP Nuget ModelContextProtocol

• तुमचा पहिला MCP Server तयार करणे.

पूर्ण C# अंमलबजावणी नमुन्यांसाठी, अधिकृत C# SDK नमुना रिपॉझिटरी पहा: https://github.com/modelcontextprotocol/csharp-sdk

नमुना अंमलबजावणी: Java अंमलबजावणी

Java SDK एंटरप्राइझ-ग्रेड वैशिष्ट्यांसह मजबूत MCP अंमलबजावणी पर्याय प्रदान करतो.

मुख्य वैशिष्ट्ये

• Spring Framework समाकलन
• मजबूत टाइप सुरक्षा
• प्रतिक्रियाशील प्रोग्रामिंग समर्थन
• सर्वसमावेशक त्रुटी हाताळणी

पूर्ण Java अंमलबजावणी नमुन्यासाठी, नमुना निर्देशिकेतील Java sample पहा.

नमुना अंमलबजावणी: JavaScript अंमलबजावणी

JavaScript SDK हलकी आणि लवचिक MCP अंमलबजावणीसाठी पर्याय देते.

मुख्य वैशिष्ट्ये

• Node.js आणि ब्राउझर समर्थन
• Promise-आधारित API
• Express आणि इतर फ्रेमवर्कसह सुलभ समाकलन
• स्ट्रीमिंगसाठी WebSocket समर्थन

पूर्ण JavaScript अंमलबजावणी नमुन्यासाठी, नमुना निर्देशिकेतील JavaScript sample पहा.

नमुना अंमलबजावणी: Python अंमलबजावणी

Python SDK उत्कृष्ट ML फ्रेमवर्क समाकलनांसह Python-आधारित MCP अंमलबजावणी देते.

मुख्य वैशिष्ट्ये

• asyncio सह Async/await समर्थन
• FastAPI समाकलन
• साधी टूल नोंदणी
• लोकप्रिय ML लायब्ररींसह नैसर्गिक समाकलन

पूर्ण Python अंमलबजावणी नमुन्यासाठी, नमुना निर्देशिकेतील Python sample पहा.

API व्यवस्थापन

Azure API Management हे MCP सर्व्हर सुरक्षित करण्याचा उत्तम उपाय आहे. कल्पना अशी आहे की तुमच्या MCP सर्व्हरच्या समोर Azure API Management इंस्टन्स ठेवायचा आणि तो खालील सारख्या वैशिष्ट्यांची जबाबदारी घेईल:

• दर मर्यादा (rate limiting)
• टोकन व्यवस्थापन
• निरीक्षण (monitoring)
• लोड बॅलन्सिंग
• सुरक्षा

Azure नमुना

खालील Azure नमुना हेच करतो, म्हणजेच MCP Server तयार करणे आणि 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 सेवा, फंक्शन अॅप (कोडसह) आणि इतर आवश्यक Azure संसाधने तयार होतील

   azd up

   हा कमांड Azure वर सर्व क्लाउड संसाधने तैनात करेल.

MCP Inspector सह तुमचा सर्व्हर चाचणी करणे

1. नवीन टर्मिनल विंडो मध्ये MCP Inspector इंस्टॉल करा आणि चालवा

   npx @modelcontextprotocol/inspector

   तुम्हाला खालीलप्रमाणे इंटरफेस दिसेल:

   

2. CTRL क्लिक करून MCP Inspector वेब अॅप URL वरून लोड करा (उदा. http://127.0.0.1:6274/#resources)

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 SDKs भाषा-विशिष्ट साधने प्रदान करतात ज्यामुळे मजबूत MCP उपाय अंमलात आणता येतात
• डिबगिंग आणि चाचणी प्रक्रिया विश्वासार्ह MCP अनुप्रयोगांसाठी अत्यंत महत्त्वाची आहे
• पुनर्वापरयोग्य प्रॉम्प्ट टेम्प्लेट्स AI संवाद सुसंगत करतात
• चांगल्या डिझाइन केलेल्या वर्कफ्लोज अनेक टूल्स वापरून गुंतागुंतीची कामे सुलभ करतात
• MCP उपाय अंमलात आणताना सुरक्षा, कार्यक्षमता आणि त्रुटी हाताळणी यांचा विचार करणे आवश्यक आहे

सराव

तुमच्या क्षेत्रातील वास्तविक समस्येवर आधारित व्यावहारिक MCP वर्कफ्लो डिझाइन करा:

1. या समस्येचे निराकरण करण्यासाठी 3-4 उपयुक्त टूल्स ओळखा
2. या टूल्स कसे परस्परसंवाद करतात हे दाखवणारा वर्कफ्लो आकृती तयार करा
3. तुमच्या पसंतीच्या भाषेत एक टूलचा मूलभूत आवृत्ती अंमलात आणा
4. मॉडेलला तुमचे टूल प्रभावीपणे वापरण्यास मदत करणारा प्रॉम्प्ट टेम्प्लेट तयार करा

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

---

पुढे: उन्नत विषय

अस्वीकरण:
हा दस्तऐवज AI अनुवाद सेवा Co-op Translator वापरून अनुवादित केला आहे. आम्ही अचूकतेसाठी प्रयत्नशील असलो तरी, कृपया लक्षात घ्या की स्वयंचलित अनुवादांमध्ये चुका किंवा अचूकतेची कमतरता असू शकते. मूळ दस्तऐवज त्याच्या स्थानिक भाषेत अधिकृत स्रोत मानला जावा. महत्त्वाच्या माहितीसाठी व्यावसायिक मानवी अनुवाद करण्याची शिफारस केली जाते. या अनुवादाच्या वापरामुळे उद्भवणाऱ्या कोणत्याही गैरसमजुती किंवा चुकीच्या अर्थलागी आम्ही जबाबदार नाही.