Skip to content

README.md

Latest commit

 

History

History
163 lines (118 loc) · 18.9 KB

README.md

File metadata and controls

163 lines (118 loc) · 18.9 KB

🚀 PostgreSQL सँग MCP सर्भर - पूर्ण सिकाइ मार्गदर्शन

🧠 MCP डेटाबेस एकीकरण सिकाइ मार्गको अवलोकन

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

तपाईं ब्याकएन्ड विकासकर्ता, एआई इञ्जिनियर, वा डाटा आर्किटेक्ट जे भए पनि, यस मार्गदर्शनले वास्तव विश्वका उदाहरणहरू र हात-मा-अभ्यासहरू सहित संरचित सिकाइ प्रदान गर्दछ, जसले तपाईंलाई निम्न MCP सर्भर https://github.com/microsoft/MCP-Server-and-PostgreSQL-Sample-Retail मार्फत लैजान्छ।

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

  • 📘 MCP दस्तावेज – विस्तृत ट्युटोरियलहरू र प्रयोगकर्ता मार्गदर्शिका
  • 📜 MCP विनिर्देशन (2025-11-25) – प्रोटोकल वास्तुकला र प्राविधिक सन्दर्भहरू
  • 🧑‍💻 MCP गिटहब भण्डार – खुला स्रोत SDK हरू, उपकरणहरू, र कोड नमूनाहरू
  • 🌐 MCP समुदाय – छलफलहरूमा सामेल हुनुहोस् र समुदायमा योगदान गर्नुहोस्
  • 🔒 OWASP MCP शीर्ष १० – सुरक्षा सर्वोत्कृष्ट अभ्यासहरू र जोखिम न्यूनिकरण

🧭 MCP डेटाबेस एकीकरण सिकाइ मार्ग

📚 https://github.com/microsoft/MCP-Server-and-PostgreSQL-Sample-Retail को लागि पूर्ण सिकाइ संरचना

ल्याब विषय विवरण लिंक
ल्याब १-३: आधारहरू
00 MCP डेटाबेस एकीकरण परिचय डेटाबेस एकीकरण र रिटेल एनालिटिक्स प्रयोग केससहित MCP को अवलोकन यहाँबाट सुरु गर्नुहोस्
01 मुख्य वास्तुकला अवधारणाहरू MCP सर्भर वास्तुकला, डेटाबेस तहहरू, र सुरक्षा ढाँचाहरूको बुझाइ सिक्नुहोस्
02 सुरक्षा र मल्टि-टेनेन्सी रो लेवल सुरक्षा, प्रमाणीकरण, र मल्टि-टेनेन्ट डेटा पहुँच सिक्नुहोस्
03 पर्यावरण सेटअप विकास वातावरण सेटअप, Docker, Azure स्रोतहरू सेटअप गर्नुहोस्
ल्याब ४-६: MCP सर्भर निर्माण
04 डेटाबेस डिजाइन र स्किमा PostgreSQL सेटअप, रिटेल स्किमा डिजाइन, र नमूना डेटा निर्माण गर्नुहोस्
05 MCP सर्भर कार्यान्वयन डेटाबेस एकीकरण सहित FastMCP सर्भर निर्माण निर्माण गर्नुहोस्
06 उपकरण विकास डेटाबेस सोधपुछ उपकरणहरू र स्किमा अवलोकन सिर्जना निर्माण गर्नुहोस्
ल्याब ७-९: उन्नत सुविधाहरू
07 सेम्यान्टिक खोज एकीकरण Azure OpenAI र pgvector सँग भेक्टर इम्बेडिङ कार्यान्वयन उन्नत गर्नुहोस्
08 परीक्षण र डिबगिङ परीक्षण रणनीतिहरू, डिबग उपकरणहरू, र मान्यकरण दृष्टिकोणहरू परीक्षण गर्नुहोस्
09 VS Code एकीकरण VS Code MCP एकीकरण र AI च्याट प्रयोग कन्फिगर गर्नुहोस् एकीकरण गर्नुहोस्
ल्याब १०-१२: उत्पादन र सर्वोत्कृष्ट अभ्यासहरू
10 परिनियोजन रणनीतिहरू Docker परिनियोजन, Azure Container Apps, र आरामदायक मापन परिनियोजन गर्नुहोस्
11 अनुगमन र अवलोकनयोग्यता एप्लिकेसन इनसाइट्स, लगिङ, प्रदर्शन अनुगमन अनुगमन गर्नुहोस्
12 सर्वोत्कृष्ट अभ्यास र अनुकूलन प्रदर्शन अनुकूलन, सुरक्षा कडा बनाउने, र उत्पादन सुझावहरू अनुकूलन गर्नुहोस्

💻 तपाईंले के निर्माण गर्नुहुनेछ

यस सिकाइ मार्गको अन्त्यसम्म, तपाईंले निम्न सुविधाहरू भएको पूर्ण जावा रिटेल एनालिटिक्स MCP सर्भर निर्माण गर्नुहुनेछ:

  • ग्राहक आदेश, उत्पादनहरू, र सूची सहित बहु-सारणी रिटेल डेटाबेस
  • स्टोर-आधारित डेटा अलगावको लागि रो लेवल सुरक्षा
  • Azure OpenAI इम्बेडिङ प्रयोग गर्दै सेम्यान्टिक उत्पादन खोज
  • प्राकृतिक भाषा सोधपुछका लागि VS Code AI च्याट एकीकरण
  • Docker र Azure सँग उत्पादन-तयार परिनियोजन
  • एप्लिकेसन इनसाइट्ससहित व्यापक अनुगमन

🎯 सिकाइका लागि पूर्वआवश्यकताहरू

यो सिकाइ मार्गबाट सबै भन्दा उपयोग उठाउन, तपाईंले निम्न थाहा हुनु आवश्यक छ:

  • प्रोग्रामिङ अनुभव: Python (रुचाइएको) वा समान भाषाहरूमा परिचित हुनु
  • डेटाबेस ज्ञान: SQL र सम्बन्धित डेटाबेसहरूको आधारभूत बुझाइ
  • API अवधारणाहरू: REST API र HTTP अवधारणाको समझ
  • विकास उपकरणहरू: कमाण्ड लाइन, Git, र कोड सम्पादकहरूमा अनुभव
  • क्लाउड आधारभूत: (ऐच्छिक) Azure वा समान क्लाउड प्लेटफर्महरूको सामान्य परिचय
  • Docker परिचय: (ऐच्छिक) कन्टेनराइजेशन अवधारणाको बुझाइ

आवश्यक उपकरणहरू

  • Docker Desktop - PostgreSQL र MCP सर्भर चलाउन
  • Azure CLI - क्लाउड स्रोतहरूको परिनियोजनका लागि
  • VS Code - विकास र MCP एकीकरणका लागि
  • Git - भर्सन नियन्त्रणका लागि
  • Python 3.8+ - MCP सर्भर विकासका लागि

📚 अध्ययन मार्गदर्शक र स्रोतहरू

यस सिकाइ मार्गमा प्रभावकारी रूपमा नेभिगेट गर्नका लागि व्यापक स्रोतहरू समावेश छन्:

अध्ययन मार्गदर्शक

हरेक ल्याबमा हुन्छन्:

  • स्पष्ट सिकाइ लक्ष्यहरू - तपाईंले के प्राप्त गर्नुहुनेछ
  • चरण-द्वारा-चरण निर्देशनहरू - विस्तृत कार्यान्वयन निर्देशिका
  • कोड उदाहरणहरू - व्याख्या सहित काम गर्ने नमूनाहरू
  • अभ्यासहरू - हात-मा अभ्यासका अवसरहरू
  • समस्या समाधान मार्गदर्शकहरू - सामान्य समस्याहरू र समाधानहरू
  • थप स्रोतहरू - थप पढाइ र अन्वेषण

पूर्वआवश्यकता जाँच

हरेक ल्याब सुरु गर्नु अघि, तपाईंले पाउनुहुनेछ:

  • आवश्यक ज्ञान - पहिले के जान्न आवश्यक छ
  • सेटअप मान्यकरण - आफ्नो वातावरण कसरी प्रमाणित गर्ने
  • समय अनुमान - अपेक्षित पूरा गर्न समय
  • सिकाइ नतिजा - समाप्ति पछि के जान्नु हुनेछ

सिफारिस गरिएका सिकाइ मार्गहरू

तपाईंको अनुभव स्तर अनुसार मार्ग छान्नुहोस्:

🟢 शुरुआती मार्ग (MCP मा नयाँ)

  1. पहिले MCP for Beginners को 0-10 समापन गर्नुहोस्
  2. आधारहरू पुनः पुष्टि गर्न ल्याब 00-03 पूरा गर्नुहोस्
  3. हात-मा निर्माणका लागि ल्याब 04-06 अनुसरण गर्नुहोस्
  4. व्यावहारिक प्रयोगका लागि ल्याब 07-09 प्रयास गर्नुहोस्

🟡 मझौला मार्ग (थोरै MCP अनुभव)

  1. डेटाबेस-विशेष अवधारणाका लागि ल्याब 00-01 समीक्षा गर्नुहोस्
  2. कार्यान्वयनका लागि ल्याब 02-06 मा ध्यान केन्द्रित गर्नुहोस्
  3. उन्नत सुविधाहरुको लागि ल्याब 07-12 मा गहिराइमा जानुहोस्

🔴 उन्नत मार्ग (MCP मा अनुभवी)

  1. पृष्ठभूमि बुझ्न ल्याब 00-03 सामान्य रूपमा हेर्नुहोस्
  2. डेटाबेस एकीकरणका लागि ल्याब 04-09 मा केन्द्रित हुनुहोस्
  3. उत्पादन परिनियोजनका लागि ल्याब 10-12 मा ध्यान दिनुहोस्

🛠️ यस सिकाइ मार्गलाई प्रभावकारी रूपमा कसरी प्रयोग गर्ने

अनुक्रमिक सिकाइ (सिफारिस गरिएको)

पूर्ण बुझाइका लागि ल्याबहरू क्रमसँग गर्नुहोस्:

  1. अवलोकन पढ्नुहोस् - तपाईंले के सिक्नुहुनेछ बुझ्नुहोस्
  2. पूर्वआवश्यकता जाँच्नुहोस् - आवश्यक ज्ञान पूरा छ कि छैन हेर्नुहोस्
  3. चरण-द्वारा-चरण निर्देशनहरू अनुसरण गर्नुहोस् - सिक्दै जाँदा कार्यान्वयन गर्नुहोस्
  4. अभ्यासहरू पूरा गर्नुहोस् - बुझाइलाई सुदृढ पार्नुहोस्
  5. मुख्य बुँदाहरू समीक्षा गर्नुहोस् - सिकाइ नतिजा बलियो पार्नुहोस्

लक्षित सिकाइ

विशेष कौशल चाहिएमा:

  • डेटाबेस एकीकरण: ल्याब 04-06 मा केन्द्रित हुनुहोस्
  • सुरक्षा कार्यान्वयन: ल्याब 02, 08, 12 मा ध्यान दिनुहोस्
  • एआई/सेम्यान्टिक खोज: ल्याब 07 मा गहिरो रूपमा जानुहोस्
  • उत्पादन परिनियोजन: ल्याब 10-12 अध्ययन गर्नुहोस्

हात-मा अभ्यास

हरेक ल्याबमा हुन्छन्:

  • काम गर्ने कोड उदाहरणहरू - प्रतिलिपि गर्नुहोस्, परिवर्तन गर्नुहोस्, र प्रयोग गर्नुहोस्
  • वास्तविक संसारका परिदृश्यहरू - व्यावहारिक रिटेल एनालिटिक्स प्रयोग केसहरू
  • क्रमिक जटिलता - साधारणदेखि उन्नत निर्माण
  • मान्यकरण चरणहरू - तपाईंको कार्यान्वयन काम गर्छ कि भनी प्रमाणित गर्नुहोस्

🌟 समुदाय र समर्थन

सहायता प्राप्त गर्नुहोस्

🚀 सुरु गर्न तयार?

तपाईंको यात्रा सुरु गर्नुहोस् ल्याब 00: MCP डेटाबेस एकीकरण परिचय बाट

डेटाबेस एकीकरणका साथ उत्पादन-तयार MCP सर्भरहरू निर्माण गर्ने यो व्यापक, हात-मा सिकाइ अनुभवसँग मास्टर गर्नुहोस्।

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