MCP-za-začetnike

GitHub prispevki GitHub težave GitHub pull-requests PRs Dobrodošli

GitHub opazovalci GitHub vilice GitHub zvezdice

Microsoft Azure AI Foundry Discord

Sledite tem korakom, da začnete uporabljati te vire:

  1. Forkajte repozitorij: Kliknite GitHub vilice
  2. Klonirajte repozitorij: git clone https://github.com/microsoft/mcp-for-beginners.git
  3. Pridružite se Azure AI Foundry Discordu in spoznajte strokovnjake ter druge razvijalce

🌐 Podpora za več jezikov

Podprto prek GitHub Action (samodejno in vedno posodobljeno)

Arabščina | Bengalščina | Bolgarščina | Burmanščina (Mjanmar) | Kitajščina (poenostavljena) | Kitajščina (tradicionalna, Hong Kong) | Kitajščina (tradicionalna, Macau) | Kitajščina (tradicionalna, Tajvan) | Hrvaščina | Češčina | Danščina | Nizozemščina | Finščina | Francoščina | Nemščina | Grščina | Hebrejščina | Hindijščina | Madžarščina | Indonezijščina | Italijanščina | Japonščina | Korejščina | Malajščina | Maratščina | Nepalščina | Norveščina | Perzijščina (Farsi) | Poljščina | Portugalščina (Brazilija) | Portugalščina (Portugalska) | Pandžabščina (Gurmukhi) | Romunščina | Ruščina | Srbščina (cirilica) | Slovaščina | Slovenščina | Španščina | Svahili | Švedščina | Tagalog (Filipino) | Tajščina | Turščina | Ukrajinščina | Urdu | Vietnamščina

🚀 Učni načrt za Model Context Protocol (MCP) za začetnike

Naučite se MCP s praktičnimi primeri kode v C#, Java, JavaScript, Rust, Python in TypeScript

🧠 Pregled učnega načrta za Model Context Protocol

Model Context Protocol (MCP) je napreden okvir, zasnovan za standardizacijo interakcij med AI modeli in odjemalskimi aplikacijami. Ta odprtokodni učni načrt ponuja strukturirano pot učenja, ki vključuje praktične primere kodiranja in resnične primere uporabe v priljubljenih programskih jezikih, kot so C#, Java, JavaScript, TypeScript in Python.

Ne glede na to, ali ste razvijalec AI, sistemski arhitekt ali programski inženir, je ta vodnik vaš celovit vir za obvladovanje osnov MCP in strategij implementacije.

🔗 Uradni viri MCP

🧭 Pregled učnega načrta MCP

📚 Celotna struktura učnega načrta

ModulTemaOpisPovezava
Modul 1-3: Osnove
00Uvod v MCPPregled Model Context Protocol in njegovega pomena v AI procesihPreberi več
01Razlaga osnovnih konceptovPodroben pregled osnovnih konceptov MCPPreberi več
02Varnost v MCPGrožnje varnosti in najboljše praksePreberi več
03Začetek z MCPNastavitev okolja, osnovni strežniki/odjemalci, integracijaPreberi več
Modul 3: Gradnja prvega strežnika in odjemalca
3.1Prvi strežnikUstvarite svoj prvi MCP strežnikVodič
3.2Prvi odjemalecRazvijte osnovni MCP odjemalecVodič
3.3Odjemalec z LLMIntegracija velikih jezikovnih modelovVodič
3.4Integracija z VS CodeUporaba MCP strežnikov v VS CodeVodič
3.5Stdio strežnikUstvarjanje strežnikov z uporabo stdio transportaVodič
3.6HTTP pretakanjeImplementacija HTTP pretakanja v MCPVodič
3.7AI orodjarnaUporaba AI orodjarne z MCPVodič
3.8TestiranjeTestiranje implementacije MCP strežnikaVodič
3.9NamestitevNamestitev MCP strežnikov v produkcijoVodič
3.10Napredna uporaba strežnikaUporaba naprednih strežnikov za izboljšane funkcije in arhitekturoVodič
3.11Enostavna avtentikacijaPoglavje, ki prikazuje avtentikacijo od začetka in RBACVodič
Modul 4-5: Praktično in napredno
04Praktična implementacijaSDK-ji, odpravljanje napak, testiranje, ponovno uporabni predlogi za pozivePreberi več
05Napredne teme v MCPMultimodalni AI, skaliranje, uporaba v podjetjihPreberi več
5.1Integracija z AzureMCP integracija z AzureVodič
5.2MultimodalnostDelo z več modalnostmiVodič
5.3OAuth2 DemoImplementacija avtentikacije OAuth2Vodič
5.4Root kontekstiRazumevanje in implementacija root kontekstovVodič
5.5UsmerjanjeStrategije usmerjanja MCPVodič
5.6VzorčenjeTehnike vzorčenja v MCPVodič
5.7SkaliranjeSkaliranje MCP implementacijVodič
5.8VarnostNapredni vidiki varnostiVodič
5.9Spletno iskanjeImplementacija funkcij spletnega iskanjaVodič
5.10Pretakanje v realnem časuGradnja funkcionalnosti pretakanja v realnem časuVodič
5.11Iskanje v realnem časuImplementacija iskanja v realnem časuVodič
5.12Entra ID avtentikacijaAvtentikacija z Microsoft Entra IDVodič
5.13Integracija z FoundryIntegracija z Azure AI FoundryVodič
5.14Inženiring kontekstaTehnike za učinkovito inženiring kontekstaVodič
5.15MCP po meri transportImplementacije transporta po meriVodič
Modul 6-10: Skupnost in najboljše prakse
06Prispevki skupnostiKako prispevati k ekosistemu MCPVodič
07Uvidi iz zgodnje uporabeZgodbe o resnični implementacijiVodič
08Najboljše prakse za MCPZmogljivost, odpornost na napake, odpornostVodič
09Študije primerov MCPPrimeri praktične implementacijeVodič
10Praktična delavnicaGradnja MCP strežnika z AI orodjarnoLaboratorij
Modul 11: Praktični laboratorij MCP strežnika
11Integracija baze podatkov MCP strežnikaCelovit 13-laboratorijski učni načrt za integracijo PostgreSQLLaboratoriji
11.1UvodPregled MCP z integracijo baze podatkov in primer uporabe analitike maloprodajeLaboratorij 00
11.2Osnovna arhitekturaRazumevanje arhitekture MCP strežnika, plasti podatkovne baze in varnostnih vzorcevLab 01
11.3Varnost in večnajemništvoVarnost na ravni vrstic, avtentikacija in dostop do podatkov več najemnikovLab 02
11.4Nastavitev okoljaNastavitev razvojnega okolja, Docker, Azure virovLab 03
11.5Oblikovanje podatkovne bazeNastavitev PostgreSQL, oblikovanje sheme za maloprodajo in vzorčni podatkiLab 04
11.6Implementacija MCP strežnikaGradnja FastMCP strežnika z integracijo podatkovne bazeLab 05
11.7Razvoj orodijUstvarjanje orodij za poizvedbe podatkovne baze in introspekcijo shemeLab 06
11.8Semantično iskanjeImplementacija vektorskih vdelav z Azure OpenAI in pgvectorLab 07
11.9Testiranje in odpravljanje napakStrategije testiranja, orodja za odpravljanje napak in pristopi za validacijoLab 08
11.10Integracija z VS CodeKonfiguracija integracije MCP z VS Code in uporaba AI ChataLab 09
11.11Strategije uvajanjaUvajanje z Dockerjem, Azure Container Apps in premisleki o skaliranjuLab 10
11.12SpremljanjeApplication Insights, beleženje in spremljanje zmogljivostiLab 11
11.13Najboljše prakseOptimizacija zmogljivosti, krepitev varnosti in nasveti za produkcijoLab 12

💻 Vzorčni projekti kode

Osnovni primeri MCP kalkulatorja

JezikOpisPovezava
C#Primer MCP strežnikaOglejte si kodo
JavaMCP kalkulatorOglejte si kodo
JavaScriptMCP demoOglejte si kodo
PythonMCP strežnikOglejte si kodo
TypeScriptPrimer MCPOglejte si kodo
RustPrimer MCPOglejte si kodo

Napredne implementacije MCP

JezikOpisPovezava
C#Napreden primerOglejte si kodo
Java s SpringPrimer aplikacije v kontejnerjuOglejte si kodo
JavaScriptNapreden primerOglejte si kodo
PythonKompleksna implementacijaOglejte si kodo
TypeScriptPrimer kontejnerjaOglejte si kodo

🎯 Predpogoji za učenje MCP

Da boste kar najbolje izkoristili to gradivo, bi morali imeti:

  • Osnovno znanje programiranja v vsaj enem od naslednjih jezikov: C#, Java, JavaScript, Python ali TypeScript

  • Razumevanje modela odjemalec-strežnik in API-jev

  • Poznavanje konceptov REST in HTTP

  • (Neobvezno) Osnovno znanje konceptov AI/ML

  • Pridružitev našim skupnostnim razpravam za podporo

📚 Vodnik za učenje in viri

Ta repozitorij vključuje več virov, ki vam bodo pomagali pri učenju:

Vodnik za učenje

Na voljo je obsežen Vodnik za učenje, ki vam bo pomagal učinkovito krmariti po tem repozitoriju. Vodnik vključuje:

  • Vizualni zemljevid učnega načrta z vsemi obravnavanimi temami
  • Podroben pregled vsakega dela repozitorija
  • Navodila za uporabo vzorčnih projektov
  • Priporočene učne poti za različne ravni znanja
  • Dodatne vire za dopolnitev vašega učenja

Dnevnik sprememb

Vzdržujemo podroben Dnevnik sprememb, ki beleži vse pomembne posodobitve učnega gradiva, vključno z:

  • Dodajanjem nove vsebine
  • Strukturnimi spremembami
  • Izboljšavami funkcij
  • Posodobitvami dokumentacije

🛠️ Kako učinkovito uporabljati ta učni načrt

Vsaka lekcija v tem vodniku vključuje:

  1. Jasne razlage konceptov MCP
  2. Žive primere kode v več jezikih
  3. Vaje za gradnjo resničnih MCP aplikacij
  4. Dodatne vire za napredne učence

Dogodki

MCP Dev Days julij 2025

➡️Oglejte si na zahtevo - MCP Dev Days

Pripravite se na dva dneva poglobljenih tehničnih vpogledov, povezovanja skupnosti in praktičnega učenja na MCP Dev Days, virtualnem dogodku, posvečenem Model Context Protocol (MCP) — nastajajočemu standardu, ki povezuje AI modele in orodja, na katera se zanašajo. MCP Dev Days si lahko ogledate z registracijo na naši strani dogodka: https://aka.ms/mcpdevdays.

1. dan: Produktivnost MCP, razvojna orodja in skupnost:

Osredotoča se na opolnomočenje razvijalcev za uporabo MCP v njihovem delovnem toku in praznovanje izjemne skupnosti MCP. Pridružili se nam bodo člani skupnosti in partnerji, kot so Arcade, Block, Okta in Neon, da pokažejo, kako sodelujejo z Microsoftom pri oblikovanju odprtega, razširljivega ekosistema MCP.
Resnični primeri uporabe v VS Code, Visual Studio, GitHub Copilot in priljubljenih orodjih skupnosti
Praktični, kontekstno usmerjeni delovni tokovi za razvijalce
Seje, ki jih vodi skupnost, in vpogledi
Ne glede na to, ali šele začenjate z MCP ali že gradite z njim, bo 1. dan postavil temelje z navdihom in uporabnimi nasveti.

2. dan: Gradnja MCP strežnikov z zaupanjem

Namenjen je graditeljem MCP. Poglobljeno bomo obravnavali strategije implementacije in najboljše prakse za ustvarjanje MCP strežnikov ter integracijo MCP v vaše AI delovne tokove.

Teme vključujejo:

  • Gradnja MCP strežnikov in njihova integracija v izkušnje z agenti
  • Razvoj, ki temelji na pozivih
  • Najboljše prakse za varnost
  • Uporaba gradnikov, kot so Functions, ACA in API Management
  • Poravnava registra in orodja (1P + 3P)

Če ste razvijalec, graditelj orodij ali strateg za AI izdelke, je ta dan poln vpogledov, ki jih potrebujete za gradnjo skalabilnih, varnih in prihodnosti pripravljenih MCP rešitev.

MCP Boot Camp avgust 2025

Naučite se v intenzivnih video sejah, kako ustvariti MCP strežnike, integrirati z VS Code in profesionalno uvajati na Azure, na podlagi vsebine iz učnega načrta MCP za začetnike. Pridobite praktične veščine v tehnologiji, ki jo že uporabljajo velike korporacije.

➡️Oglejte si na zahtevo MCP Bootcamp | Angleščina

➡️Oglejte si na zahtevo MCP Bootcamp | Brazilščina

➡️Oglejte si na zahtevo MCP Bootcamp | Španščina

Naučimo se MCP s C# - Serija vaj

Naučimo se Model Context Protocol (MCP), naprednega okvira, zasnovanega za standardizacijo interakcij med AI modeli in odjemalskimi aplikacijami. V tej prijazni seji za začetnike vas bomo uvedli v MCP in vas vodili skozi ustvarjanje vašega prvega MCP strežnika.

C#: https://aka.ms/letslearnmcp-csharp

Java: https://aka.ms/letslearnmcp-java

JavaScript: https://aka.ms/letslearnmcp-javascript

Python: https://aka.ms/letslearnmcp-python

🌟 Zahvala skupnosti

Hvala Microsoftovemu cenjenemu strokovnjaku Shivam Goyal za prispevek pomembnih vzorcev kode.

📜 Informacije o licenci

Ta vsebina je licencirana pod MIT licenco. Za pogoje in določila glejte LICENSE.

🤝 Smernice za prispevanje

Ta projekt pozdravlja prispevke in predloge. Večina prispevkov zahteva, da se strinjate s Sporazumom o licenci za prispevanje (CLA), ki potrjuje, da imate pravico in dejansko podeljujete pravice za uporabo vašega prispevka. Za podrobnosti obiščite https://cla.opensource.microsoft.com.

Ko oddate zahtevo za združitev, bo bot CLA samodejno določil, ali morate zagotoviti CLA, in ustrezno označil PR (npr. preverjanje stanja, komentar). Preprosto sledite navodilom, ki jih zagotovi bot. To boste morali storiti le enkrat za vse repozitorije, ki uporabljajo naš CLA.

Ta projekt je sprejel Microsoftov kodeks ravnanja za odprtokodno programsko opremo. Za več informacij si oglejte Pogosta vprašanja o kodeksu ravnanja ali kontaktirajte opencode@microsoft.com za dodatna vprašanja ali komentarje.

📂 Struktura repozitorija

Repozitorij je organiziran na naslednji način:

  • Osnovni učni načrt (00-11): Glavna vsebina, organizirana v enajst zaporednih modulov, vključno s celovitimi laboratoriji za integracijo podatkovnih baz
  • 11-MCPServerHandsOnLabs/: Popolna učna pot s 13 laboratoriji za gradnjo produkcijsko pripravljenih MCP strežnikov z integracijo PostgreSQL
  • images/: Diagrami in ilustracije, uporabljeni v učnem načrtu
  • translations/: Podpora za več jezikov z avtomatiziranimi prevodi
  • translated_images/: Lokalizirane različice diagramov in ilustracij
  • study_guide.md: Obsežen vodnik za navigacijo po repozitoriju
  • changelog.md: Zapis vseh pomembnih sprememb v učnem gradivu
  • mcp.json: Konfiguracijska datoteka za specifikacijo MCP
  • CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Dokumenti za upravljanje projekta

🎒 Drugi tečaji

Naša ekipa pripravlja tudi druge tečaje! Oglejte si:

™️ Obvestilo o blagovni znamki

Ta projekt lahko vsebuje blagovne znamke ali logotipe za projekte, izdelke ali storitve. Dovoljena uporaba Microsoftovih blagovnih znamk ali logotipov mora biti skladna z in upoštevati Microsoftove smernice za blagovne znamke in znamčenje. Uporaba Microsoftovih blagovnih znamk ali logotipov v spremenjenih različicah tega projekta ne sme povzročiti zmede ali nakazovati, da projekt sponzorira Microsoft. Vsaka uporaba blagovnih znamk ali logotipov tretjih oseb mora biti skladna s politikami teh tretjih oseb.

Pomoč

Če se zataknete ali imate kakršna koli vprašanja o gradnji AI aplikacij, se pridružite:

Azure AI Foundry Discord

Če imate povratne informacije o izdelku ali naletite na napake med gradnjo, obiščite:

Azure AI Foundry Developer Forum


Omejitev odgovornosti:
Ta dokument je bil preveden z uporabo storitve za prevajanje z umetno inteligenco Co-op Translator. Čeprav si prizadevamo za natančnost, vas prosimo, da upoštevate, da lahko avtomatski prevodi vsebujejo napake ali netočnosti. Izvirni dokument v njegovem maternem jeziku je treba obravnavati kot avtoritativni vir. Za ključne informacije priporočamo profesionalni človeški prevod. Ne prevzemamo odgovornosti za morebitna nesporazumevanja ali napačne razlage, ki izhajajo iz uporabe tega prevoda.