9.2 KiB
🚀 MCP server koos PostgreSQL-iga – täielik õppematerjal
🧠 Ülevaade MCP andmebaasi integratsiooni õppimisteest
See põhjalik õppematerjal õpetab, kuidas ehitada tootmiskõlblikke Model Context Protocol (MCP) servereid, mis integreeruvad andmebaasidega praktilise jaemüügi analüüsi näite kaudu. Õpid ettevõtte tasemel mustreid, sealhulgas reaalset juurdepääsuturvalisust (Row Level Security, RLS), semantilist otsingut, Azure AI integratsiooni ja mitme rentnikuga andmete juurdepääsu.
Oled sa siis backend arendaja, AI insener või andmearhitekt, see juhend pakub struktureeritud õppimist reaalse elu näidete ja praktiliste harjutustega, mis juhatavad sind läbi MCP serveri https://github.com/microsoft/MCP-Server-and-PostgreSQL-Sample-Retail.
🔗 Ametlikud MCP ressursid
- 📘 MCP dokumentatsioon – üksikasjalikud juhendid ja kasutajajuhised
- 📜 MCP spetsifikatsioon (2025-11-25) – protokolli arhitektuur ja tehnilised viited
- 🧑💻 MCP GitHub hoidla – avatud lähtekoodiga SDK-d, tööriistad ja koodinäited
- 🌐 MCP kogukond – liitu aruteludega ja panusta kogukonda
- 🔒 OWASP MCP Top 10 – turvalisuse parimad tavad ja riskimaandamine
🧭 MCP andmebaasi integratsiooni õppimistee
📚 Täielik õppematerjalide struktuur aadressil https://github.com/microsoft/MCP-Server-and-PostgreSQL-Sample-Retail
| Labor | Teema | Kirjeldus | Link |
|---|---|---|---|
| Laborid 1-3: Alused | |||
| 00 | Sissejuhatus MCP andmebaasi integratsiooni | Ülevaade MCP-st koos andmebaasi integratsiooni ja jaemüügi analüüsi kasutusjuhuga | Alusta siit |
| 01 | Põhiarhitektuuri kontseptsioonid | MCP serveri arhitektuuri, andmebaasi kihistuse ja turvamustrite mõistmine | Õpi |
| 02 | Turvalisus ja mitu rentnikku | Rea tase turvalisus, autentimine ja mitme rentnikuga andmete juurdepääs | Õpi |
| 03 | Keskkonna seadistamine | Arenduskeskkonna häälestus, Docker, Azure ressursid | Seadista |
| Laborid 4-6: MCP serveri ehitamine | |||
| 04 | Andmebaasi disain ja skeem | PostgreSQL seadistamine, jaemüügi skeemi kavandamine ja näidisandmed | Ehita |
| 05 | MCP serveri rakendus | FastMCP serveri loomine andmebaasi integratsiooniga | Ehita |
| 06 | Tööriistade arendus | Andmebaasi päringutööriistade ja skeemi introspektsiooni loomine | Ehita |
| Laborid 7-9: Täiustatud funktsioonid | |||
| 07 | Semantilise otsingu integratsioon | Vektorite manustamise kasutamine Azure OpenAI ja pgvector abil | Täitma |
| 08 | Testimine ja silumine | Testimise strateegiad, silumise tööriistad ja valideerimisvõtted | Testi |
| 09 | VS Code integratsioon | VS Code MCP integratsiooni ja AI vestluse seadistamine | Integreeri |
| Laborid 10-12: Tootmine ja parimad tavad | |||
| 10 | Väljalaskmisstrateegiad | Docker'i väljalaskmine, Azure Container Apps ja skaleerimine | Väljalase |
| 11 | Jälgimine ja jälgitavus | Application Insights, logimine ja jõudlusmonitooring | Jälgi |
| 12 | Parimad tavad ja optimeerimine | Jõudluse optimeerimine, turvasoojenemine ja tootmise näpunäited | Optimeeri |
💻 Mida sa ehitad
Selle õppimistee lõpuks oled loonud täieliku Zava Retail Analytics MCP serveri, mis sisaldab:
- Mitme tabeliga jaemüügi andmebaas klienditellimuste, toodete ja laoseisuga
- Rea taseme turvalisus poodipõhise andmete eraldatuse jaoks
- Semantiline tooteloenduse otsing kasutades Azure OpenAI manustusi
- VS Code AI vestluse integratsioon loomuliku keelepäringute jaoks
- Tootmiskõlblik juurutamine Docker ja Azure abil
- Põhjalik jälgimine Application Insightsiga
🎯 Õppimise eeltingimused
Parima tulemuse saamiseks peaksid omama:
- Programmeerimiskogemus: Python'i (soovitavalt) või sarnaste keelte tundmine
- Andmebaasi teadmised: Põhiline SQL ja relatsioonandmebaaside arusaam
- API kontseptsioonid: REST API-de ja HTTP mõistmine
- Arendusvahendid: Käsurea, Git'i ja koodiredaktorite kasutamise kogemus
- Pilve põhialused: (valikuline) teadmised Azure või sarnastest pilveplatvormidest
- Dockeri tundmine: (valikuline) konteinerite kontseptsioonide mõistmine
Nõutavad tööriistad
- Docker Desktop – PostgreSQL ja MCP serveri käivitamiseks
- Azure CLI – pilveressursside juurutamiseks
- VS Code – arendamiseks ja MCP integratsiooniks
- Git – versioonihalduseks
- Python 3.8+ – MCP serveri arendamiseks
📚 Õppejuhend ja ressursid
See õppeteekond sisaldab põhjalikke ressursse efektiivseks orienteerumiseks:
Õppejuhend
Igas laboris on:
- Selged õppesmärgid – mida saavutad
- Samm-sammult juhised – detailne rakendustegevus
- Koodinäited – toimivad näited koos selgitustega
- Harjutused – praktilised õpivõimalused
- Veaotsingu juhendid – levinumad probleemid ja lahendused
- Lisaressursid – täiendav lugemine ja süvenemine
Eeltingimuste kontroll
Enne iga laborit leiad:
- Nõutavad teadmised – mida peaksid oskama
- Seadistuse valideerimine – kuidas kontrollida oma keskkonda
- Ajalised hinnangud – eeldatav lõpetamise aeg
- Õpitulemused – mida tead pärast lõpetamist
Soovitatud õppeteed
Vali tee oma kogemuse põhjal:
🟢 Algajate tee (Uus MCP-s)
- Veendu, et oled lõpetanud esmalt 0-10 osa MCP algajatele
- Täida laborid 00-03, et kinnistada põhialused
- Järgi laboreid 04-06 praktiliseks ehitamiseks
- Proovi laboreid 07-09 praktiliseks kasutamiseks
🟡 Kesktaseme tee (Mõningase MCP kogemusega)
- Vaata üle laborid 00-01 andmebaasile orienteeritud kontseptsioonide jaoks
- Keskendu laboritele 02-06 rakenduseks
- Süvene laboritesse 07-12 täiendavate funktsioonide jaoks
🔴 Edasijõudnute tee (Kogenud MCP kasutajale)
- Tutvu kiiresti laboritega 00-03 konteksti saamiseks
- Keskendu laboritele 04-09 andmebaasi integratsiooniks
- Keskendu laboritele 10-12 tootmisse juurutamiseks
🛠️ Kuidas seda õppimisteed tõhusalt kasutada
Järjestikune õppimine (Soovitatav)
Läbi töötamine laboris järjekorras terviklikuks arusaamiseks:
- Loe ülevaadet – mõista, mida õpid
- Kontrolli eeltingimusi – kindlusta teadmised
- Järgi samm-sammult juhiseid – rakenda õppides
- Lõpeta harjutused – kinnista teadmisi
- Vaata üle põhivõtted – süvenda õpitut
Sihtotstarbeline õppimine
Kui vajad spetsiifilisi oskusi:
- Andmebaasi integratsioon: Keskendu laboritele 04-06
- Turva rakendamine: Keskendu laboritele 02, 08, 12
- AI / semantiline otsing: Süvene laboris 07
- Tootmisse juurutamine: Uuri laborite 10-12 materjali
Praktiline harjutamine
Igas laboris:
- Toimivad koodinäited – kopeeri, muuda ja eksperimenteeri
- Reaalelu stsenaariumid – praktilised jaemüügi analüüsi kasutusjuhud
- Samm-sammult keerukuse kasv – ehitus lihtsast keerukani
- Valideerimise sammud – kontrolli, et su rakendus töötab
🌟 Kogukond ja tugi
Abi saamine
- Azure AI Discord: Liitu ekspertide toe jaoks
- GitHub hoidla ja rakenduse näidis: Juurutamise näidis ja ressursid
- MCP kogukond: Liitu MCP aruteludega
🚀 Valmis alustama?
Alusta oma teekonda Labor 00: MCP andmebaasi integratsiooni sissejuhatus
Valmista tootmiskõlblikku MCP serverit, mis ühendub andmebaasidega, selle põhjaliku ja praktilise õppimise kaudu.
Vastutusest loobumine:
See dokument on tõlgitud kasutades tehisintellekti tõlketeenust Co-op Translator. Kuigi me püüame täpsust, palun pange tähele, et automatiseeritud tõlked võivad sisaldada vigu või ebatäpsusi. Originaaldokument selle emakeeles tuleks pidada autoriteetseks allikaks. Kriitilise teabe puhul soovitatakse kasutada professionaalset inimtõlget. Me ei vastuta üheseltmõistmuste ega valesti tõlgendamise eest, mis võivad tuleneda selle tõlke kasutamisest.