Skip to content

Latest commit

 

History

History
264 lines (194 loc) · 18.8 KB

File metadata and controls

264 lines (194 loc) · 18.8 KB

MCP-for-beginners

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Azure AI Foundry Discord

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

  1. Razvejite repozitorij: Kliknite GitHub forks
  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 preko GitHub Action (avtomatizirano in vedno posodobljeno)

French | Spanish | German | Russian | Arabic | Persian (Farsi) | Urdu | Chinese (Simplified) | Chinese (Traditional, Macau) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Taiwan) | Japanese | Korean | Hindi | Bengali | Marathi | Nepali | Punjabi (Gurmukhi) | Portuguese (Portugal) | Portuguese (Brazil) | Italian | Polish | Turkish | Greek | Thai | Swedish | Danish | Norwegian | Finnish | Dutch | Hebrew | Vietnamese | Indonesian | Malay | Tagalog (Filipino) | Swahili | Hungarian | Czech | Slovak | Romanian | Bulgarian | Serbian (Cyrillic) | Croatian | Slovenian | Ukrainian | Burmese (Myanmar)

🚀 Kurikulum Model Context Protocol (MCP) za začetnike

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

🧠 Pregled kurikuluma Model Context Protocol

Model Context Protocol (MCP) je najsodobnejši okvir, zasnovan za standardizacijo interakcij med AI modeli in odjemalskimi aplikacijami. Ta odprtokodni kurikulum ponuja strukturirano učno pot, 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 vodič vaš celovit vir za obvladovanje osnov MCP in strategij implementacije.

🔗 Uradni viri MCP

Pridružite se MCP Dev Days 29. in 30. julija 2025

Pripravite se na dva dni 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 katerih temeljijo.

➡️ Registrirajte se za MCP Dev Days

Dogodek MCP Dev Days lahko spremljate z registracijo na naši strani dogodka: https://aka.ms/mcpdevdays. Od tam boste lahko spremljali prenos v živo na YouTubu ali Twitchu. Vse vsebine bodo posnete in na voljo kasneje na Microsoft Developer YouTube kanalu. Izvorna koda za demonstracije bo prav tako na voljo na GitHubu.

Podrobnosti dogodka

  • Datumi: 29. julij (1. dan) in 30. julij (2. dan)
  • Čas: vsak dan ob 9:00 PST
  • Kje: spletno – pridružite se od kjerkoli!

1. dan: MCP produktivnost, razvojna orodja in skupnost

Osredotočen je na opolnomočenje razvijalcev za uporabo MCP v njihovem delovnem toku in praznovanje izjemne MCP skupnosti. 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 MCP ekosistema. Resnični primeri uporabe v VS Code, Visual Studio, GitHub Copilot in priljubljenih orodjih skupnosti. Praktični, kontekstno usmerjeni razvojni delovni tokovi Seje in vpogledi, ki jih vodi skupnost Ne glede na to, ali šele začenjate z MCP ali že razvijate z njim, bo 1. dan postavil temelje z navdihom in uporabnimi nasveti.

2. dan: Zgradite MCP strežnike samozavestno

Namenjen je razvijalcem 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 agentov
  • Razvoj, ki ga vodi pozivanje (prompt-driven development)
  • Najboljše varnostne prakse
  • Uporaba gradnikov, kot so Functions, ACA in API Management
  • Usklajevanje registra in orodja (1P + 3P)

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

🧭 Pregled kurikuluma MCP

📚 Celotna struktura kurikuluma

Modul Tema Opis Povezava
Moduli 1-3: Osnove
00 Uvod v MCP Pregled Model Context Protocol in njegov pomen v AI procesih Preberi več
01 Razlaga osnovnih pojmov Poglobljen pregled osnovnih konceptov MCP Preberi več
02 Varnost v MCP Varnostne grožnje in najboljše prakse Preberi več
03 Začetek z MCP Nastavitev okolja, osnovni strežniki/odjemalci, integracija Preberi več
Modul 3: Gradnja prvega strežnika in odjemalca
3.1 Prvi strežnik Ustvarite svoj prvi MCP strežnik Vodič
3.2 Prvi odjemalec Razvijte osnovni MCP odjemalec Vodič
3.3 Odjemalec z LLM Integrirajte velike jezikovne modele Vodič
3.4 Integracija v VS Code Uporabite MCP strežnike v VS Code Vodič
3.5 SSE strežnik Ustvarite strežnike z uporabo Server-Sent Events Vodič
3.6 HTTP pretakanje Implementirajte HTTP pretakanje v MCP Vodič
3.7 AI orodjarna Uporabite AI Toolkit z MCP Vodič
3.8 Testiranje Testirajte svojo implementacijo MCP strežnika Vodič
3.9 Namestitev Namestite MCP strežnike v produkcijo Vodič
Moduli 4-5: Praktično in napredno
04 Praktična implementacija SDK-ji, odpravljanje napak, testiranje, ponovno uporabne predloge pozivov Preberi več
05 Napredne teme v MCP Večmodalni AI, skaliranje, uporaba v podjetjih Preberi več
5.1 Integracija z Azure MCP integracija z Azure Vodič
5.2 Večmodalnost Delo z več modalitetami Vodič
5.3 OAuth2 demo Implementacija OAuth2 avtentikacije Vodič
5.4 Root konteksti Razumevanje in implementacija root kontekstov Vodič
5.5 Usmerjanje Strategije usmerjanja MCP Vodič
5.6 Vzorcevanje Tehnike vzorcevanja v MCP Vodič
5.7 Skaliranje Skaliranje MCP implementacij Vodič
5.8 Varnost Napredne varnostne razmisleke Vodič
5.9 Iskanje po spletu Implementacija spletnega iskanja Vodič
5.10 Pretakanje v realnem času Gradnja funkcionalnosti pretakanja v realnem času Vodič
5.11 Iskanje v realnem času Implementacija iskanja v realnem času Vodič
5.12 Entra ID Avtentikacija Avtentikacija z Microsoft Entra ID Vodnik
5.13 Integracija Foundry Integracija z Azure AI Foundry Vodnik
5.14 Kontekstno inženirstvo Tehnike za učinkovito kontekstno inženirstvo Vodnik
Moduli 6-10: Skupnost in najboljše prakse
06 Prispevki skupnosti Kako prispevati v MCP ekosistem Vodnik
07 Izkušnje zgodnjih uporabnikov Resnične zgodbe o implementaciji Vodnik
08 Najboljše prakse za MCP Zmogljivost, odpornost, vzdržljivost Vodnik
09 MCP študije primerov Praktični primeri implementacije Vodnik
10 Delavnica v živo Gradnja MCP strežnika z AI orodji Lab

💻 Primeri kode

Osnovni primeri MCP kalkulatorja

Jezik Opis Povezava
C# Primer MCP strežnika Ogled kode
Java MCP kalkulator Ogled kode
JavaScript MCP demo Ogled kode
Python MCP strežnik Ogled kode
TypeScript MCP primer Ogled kode

Napredne implementacije MCP

Jezik Opis Povezava
C# Napredni primer Ogled kode
Java Primer aplikacije v kontejnerju Ogled kode
JavaScript Napredni primer Ogled kode
Python Kompleksna implementacija Ogled kode
TypeScript Primer kontejnerja Ogled kode

🎯 Predpogoji za učenje MCP

Da boste iz tega učnega načrta kar najbolje izkoristili, morate imeti:

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

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

  • Poznavanje konceptov REST in HTTP

  • (Neobvezno) Osnove AI/ML konceptov

  • Sodelovanje v naših skupnostnih razpravah za podporo

📚 Učni načrt in viri

Ta repozitorij vsebuje več virov, ki vam pomagajo učinkovito raziskovati in se učiti:

Učni načrt

Na voljo je obsežen Učni načrt, ki vam pomaga učinkovito krmariti po repozitoriju. Vključuje:

  • Vizualni zemljevid učnega načrta z vsemi obravnavanimi temami
  • Podroben razčlenitev posameznih delov repozitorija
  • Navodila za uporabo primerov projektov
  • Priporočene učne poti za različne ravni znanja
  • Dodatne vire za dopolnitev vašega učenja

Zapis sprememb

Vzdržujemo podroben Zapis sprememb, ki sledi vsem pomembnim posodobitvam učnih gradiv, 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. Jasna pojasnila konceptov MCP
  2. Žive primere kode v več jezikih
  3. Vaje za izdelavo pravih MCP aplikacij
  4. Dodatne vire za napredne učence

🌟 Zahvala skupnosti

Zahvala Microsoft Valued Professional Shivam Goyal za prispevek pomembnih primerov kode.

📜 Informacije o licenci

Ta vsebina je licencirana pod MIT licenco. Za pogoje glejte LICENSE.

🤝 Navodila za prispevke

Ta projekt sprejema prispevke in predloge. Večina prispevkov zahteva, da se strinjate s Contributor License Agreement (CLA), s katerim izjavite, da imate pravico in dejansko dovolite, da uporabljamo vaš prispevek. Za podrobnosti obiščite https://cla.opensource.microsoft.com.

Ko oddate pull request, bo CLA bot samodejno preveril, ali morate predložiti CLA in ustrezno označil PR (npr. statusni pregled, komentar). Preprosto sledite navodilom, ki jih poda bot. To boste morali storiti le enkrat za vse repozitorije, ki uporabljajo naš CLA.

Ta projekt je sprejel Microsoft Open Source Code of Conduct. Za več informacij glejte Pogosta vprašanja o kodeksu ravnanja ali kontaktirajte opencode@microsoft.com za dodatna vprašanja ali komentarje.

📂 Struktura repozitorija

Repozitorij je organiziran tako:

  • Glavni učni načrt (00-10): Glavna vsebina razdeljena v deset zaporednih modulov
  • 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 krmarjenje po repozitoriju
  • changelog.md: Zapis vseh pomembnih sprememb učnih gradiv
  • mcp.json: Konfiguracijska datoteka za MCP specifikacijo
  • 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. Pooblaščena uporaba Microsoftovih blagovnih znamk ali logotipov je predmet in mora slediti Microsoftovim smernicam za uporabo blagovnih znamk in znamk. Uporaba Microsoftovih blagovnih znamk ali logotipov v spremenjenih različicah tega projekta ne sme povzročati zmede ali nakazovati sponzorstva Microsofta. Vsaka uporaba blagovnih znamk ali logotipov tretjih oseb je predmet pravil teh tretjih oseb.

Omejitev odgovornosti:
Ta dokument je bil preveden z uporabo AI prevajalske storitve Co-op Translator. Čeprav si prizadevamo za natančnost, vas opozarjamo, da avtomatizirani prevodi lahko vsebujejo napake ali netočnosti. Izvirni dokument v njegovem izvirnem jeziku velja za avtoritativni vir. Za ključne informacije priporočamo strokovni človeški prevod. Za morebitna nesporazume ali napačne interpretacije, ki izhajajo iz uporabe tega prevoda, ne odgovarjamo.