Skip to content

Latest commit

 

History

History
264 lines (194 loc) · 19 KB

File metadata and controls

264 lines (194 loc) · 19 KB

MCP-for-beginners

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Azure AI Foundry Discord

Slijedite ove korake kako biste započeli s korištenjem ovih resursa:

  1. Forkajte repozitorij: Kliknite GitHub forks
  2. Klonirajte repozitorij: git clone https://github.com/microsoft/mcp-for-beginners.git
  3. Pridružite se Azure AI Foundry Discord zajednici i upoznajte stručnjake i kolege developere

🌐 Podrška za više jezika

Podržano putem GitHub Action (Automatski i uvijek ažurirano)

Francuski | Španjolski | Njemački | Ruski | Arapski | Perzijski (Farsi) | Urdu | Kineski (pojednostavljeni) | Kineski (tradicionalni, Makao) | Kineski (tradicionalni, Hong Kong) | Kineski (tradicionalni, Tajvan) | Japanski | Korejski | Hindi | Bengalski | Marathi | Nepalski | Punjabi (Gurmukhi) | Portugalski (Portugal) | Portugalski (Brazil) | Talijanski | Poljski | Turski | Grčki | Tajlandski | Švedski | Danski | Norveški | Finski | Nizozemski | Hebrejski | Vijetnamski | Indonezijski | Malajski | Tagalog (Filipinski) | Svahili | Mađarski | Češki | Slovački | Rumunjski | Bugarski | Srpski (ćirilica) | Hrvatski | Slovenski | Ukrajinski | Burmanski (Myanmar)

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

Naučite MCP kroz praktične primjere koda u C#, Java, JavaScript, Python i TypeScript

🧠 Pregled kurikuluma Model Context Protocol

Model Context Protocol (MCP) je napredni okvir osmišljen za standardizaciju interakcija između AI modela i klijentskih aplikacija. Ovaj open-source kurikulum nudi strukturirani put učenja, s praktičnim primjerima koda i stvarnim slučajevima korištenja, na popularnim programskim jezicima kao što su C#, Java, JavaScript, TypeScript i Python.

Bilo da ste AI developer, sistemski arhitekt ili softverski inženjer, ovaj vodič je vaš sveobuhvatni resurs za savladavanje osnova MCP-a i strategija implementacije.

🔗 Službeni MCP resursi

Pridružite nam se na MCP Dev Days 29.-30. srpnja 2025.

Pripremite se za dva dana dubinskih tehničkih uvida, povezivanja zajednice i praktičnog učenja na MCP Dev Days, virtualnom događaju posvećenom Model Context Protocolu (MCP) — novom standardu koji povezuje AI modele i alate na kojima se oslanjaju.

➡️ Registrirajte se za MCP Dev Days

MCP Dev Days možete pratiti prijavom na našu stranicu događaja: https://aka.ms/mcpdevdays. Tamo ćete moći pratiti prijenos uživo na YouTubeu ili Twitchu. Sav sadržaj bit će snimljen i dostupan naknadno na Microsoft Developer YouTube kanalu. Izvorni kod za demonstracije bit će dostupan i na GitHubu.

Detalji događaja

  • Datumi: 29. srpnja (1. dan) i 30. srpnja (2. dan)
  • Vrijeme: 9:00 AM PST svaki dan
  • Lokacija: Online – pridružite se odakle god želite!

Dan 1: MCP Produktivnost, DevTools i Zajednica

Posvećen je osnaživanju developera da koriste MCP u svom razvojnom tijeku i proslavi sjajne MCP zajednice. Pridružit će nam se članovi zajednice i partneri poput Arcade, Block, Okta i Neon kako bismo vidjeli kako surađuju s Microsoftom na oblikovanju otvorenog, proširivog MCP ekosustava. Demonstracije iz stvarnog svijeta kroz VS Code, Visual Studio, GitHub Copilot i popularne alate zajednice
Praktični, kontekstualno vođeni razvojni tijekovi
Sesije i uvide vođene od strane zajednice
Bilo da tek započinjete s MCP-om ili već razvijate s njim, Dan 1 će postaviti temelje s inspiracijom i konkretnim savjetima.

Dan 2: Izgradite MCP Servere s Povjerenjem

Namijenjen je MCP developerima. Duboko ćemo zaroniti u strategije implementacije i najbolje prakse za kreiranje MCP servera i integraciju MCP-a u vaše AI radne tokove.

Teme uključuju:

  • Izgradnja MCP servera i njihova integracija u agent iskustva
  • Razvoj vođen promptovima
  • Najbolje sigurnosne prakse
  • Korištenje građevnih blokova poput Functions, ACA i API Management
  • Usklađivanje registra i alati (1P + 3P)

Ako ste developer, tvorac alata ili strateg za AI proizvode, ovaj dan je prepun uvida potrebnih za izgradnju skalabilnih, sigurnih i spremnih za budućnost MCP rješenja.

🧭 Pregled MCP kurikuluma

📚 Struktura kompletnog kurikuluma

Modul Tema Opis Link
Modul 1-3: Osnove
00 Uvod u MCP Pregled Model Context Protocola i njegova važnost u AI procesima Pročitaj više
01 Objašnjenje osnovnih pojmova Detaljno objašnjenje osnovnih MCP pojmova Pročitaj više
02 Sigurnost u MCP-u Sigurnosne prijetnje i najbolje prakse Pročitaj više
03 Početak rada s MCP-om Postavljanje okruženja, osnovni serveri/klijenti, integracija Pročitaj više
Modul 3: Izgradnja prvog servera i klijenta
3.1 Prvi server Kreirajte svoj prvi MCP server Vodič
3.2 Prvi klijent Razvijte osnovni MCP klijent Vodič
3.3 Klijent s LLM-om Integrirajte velike jezične modele Vodič
3.4 Integracija u VS Code Koristite MCP servere u VS Code-u Vodič
3.5 SSE server Kreirajte servere koristeći Server-Sent Events Vodič
3.6 HTTP streaming Implementirajte HTTP streaming u MCP-u Vodič
3.7 AI Toolkit Koristite AI Toolkit s MCP-om Vodič
3.8 Testiranje Testirajte implementaciju MCP servera Vodič
3.9 Deploy Postavite MCP servere u produkciju Vodič
Modul 4-5: Praktično i napredno
04 Praktična implementacija SDK-ovi, debugiranje, testiranje, ponovo upotrebljivi predlošci promptova Pročitaj više
05 Napredne teme u MCP-u Multimodalni AI, skaliranje, enterprise primjena Pročitaj više
5.1 Azure integracija MCP integracija s Azureom Vodič
5.2 Multimodalnost Rad s više modaliteta Vodič
5.3 OAuth2 demo Implementacija OAuth2 autentifikacije Vodič
5.4 Root konteksti Razumijevanje i implementacija root konteksta Vodič
5.5 Routing Strategije usmjeravanja u MCP-u Vodič
5.6 Uzorkovanje Tehnike uzorkovanja u MCP-u Vodič
5.7 Skaliranje Skaliranje MCP implementacija Vodič
5.8 Sigurnost Napredne sigurnosne mjere Vodič
5.9 Web pretraživanje Implementacija web pretraživanja Vodič
5.10 Realtime streaming Izgradnja funkcionalnosti za streaming u stvarnom vremenu Vodič
5.11 Realtime pretraživanje Implementacija pretraživanja u stvarnom vremenu Vodič
5.12 Entra ID autentifikacija Autentifikacija s Microsoft Entra ID Vodič
5.13 Integracija Foundry Integracija s Azure AI Foundry Vodič
5.14 Inženjering konteksta Tehnike za učinkoviti inženjering konteksta Vodič
Modul 6-10: Zajednica i najbolje prakse
06 Doprinosi zajednice Kako doprinijeti MCP ekosustavu Vodič
07 Uvidi iz ranog usvajanja Priče o stvarnim implementacijama Vodič
08 Najbolje prakse za MCP Performanse, otpornost na greške, izdržljivost Vodič
09 MCP studije slučaja Primjeri praktičnih implementacija Vodič
10 Praktična radionica Izgradnja MCP servera s AI Toolkitom Laboratorij

💻 Primjeri koda

Osnovni MCP kalkulator primjeri

Jezik Opis Link
C# Primjer MCP servera Pogledaj kod
Java MCP kalkulator Pogledaj kod
JavaScript MCP demo Pogledaj kod
Python MCP server Pogledaj kod
TypeScript MCP primjer Pogledaj kod

Napredne MCP implementacije

Jezik Opis Link
C# Napredni primjer Pogledaj kod
Java Primjer Container aplikacije Pogledaj kod
JavaScript Napredni primjer Pogledaj kod
Python Složena implementacija Pogledaj kod
TypeScript Primjer Container aplikacije Pogledaj kod

🎯 Preduvjeti za učenje MCP-a

Da biste maksimalno iskoristili ovaj kurikulum, trebali biste imati:

  • Osnovno znanje programiranja u barem jednom od sljedećih jezika: C#, Java, JavaScript, Python ili TypeScript

  • Razumijevanje klijent-server modela i API-ja

  • Poznavanje REST i HTTP koncepata

  • (Opcionalno) Pozadinu u AI/ML konceptima

  • Sudjelovanje u raspravama naše zajednice za podršku

📚 Vodič za učenje i resursi

Ovaj repozitorij sadrži nekoliko resursa koji će vam pomoći da se lakše snađete i učinkovito učite:

Vodič za učenje

Dostupan je sveobuhvatan Vodič za učenje koji će vam pomoći da se učinkovito krećete kroz ovaj repozitorij. Vodič uključuje:

  • Vizualnu mapu kurikuluma sa svim obrađenim temama
  • Detaljan pregled svakog dijela repozitorija
  • Upute kako koristiti primjere projekata
  • Preporučene putanje učenja za različite razine znanja
  • Dodatne resurse koji nadopunjuju vaš proces učenja

Dnevnik promjena

Vodimo detaljan Dnevnik promjena koji prati sve značajne nadopune materijala kurikuluma, uključujući:

  • Dodavanje novog sadržaja
  • Strukturne promjene
  • Poboljšanja funkcionalnosti
  • Ažuriranja dokumentacije

🛠️ Kako učinkovito koristiti ovaj kurikulum

Svaka lekcija u ovom vodiču uključuje:

  1. Jasna objašnjenja MCP koncepata
  2. Primjere koda uživo na više jezika
  3. Vježbe za izgradnju stvarnih MCP aplikacija
  4. Dodatne resurse za napredne učenike

🌟 Zahvale zajednici

Zahvaljujemo Microsoft Valued Professional Shivam Goyal na doprinosu važnih primjera koda.

📜 Informacije o licenci

Ovaj sadržaj licenciran je pod MIT licencom. Za uvjete korištenja pogledajte LICENSE.

🤝 Smjernice za doprinos

Ovaj projekt prihvaća doprinose i prijedloge. Većina doprinosa zahtijeva da pristanete na Contributor License Agreement (CLA) kojim potvrđujete da imate pravo i doista dajete prava za korištenje vašeg doprinosa. Za detalje posjetite https://cla.opensource.microsoft.com.

Kada pošaljete pull request, CLA bot će automatski provjeriti trebate li dostaviti CLA i označiti PR na odgovarajući način (npr. status check, komentar). Jednostavno slijedite upute bota. Ovo je potrebno napraviti samo jednom za sve repozitorije koji koriste naš CLA.

Ovaj projekt je usvojio Microsoft Open Source Code of Conduct. Za više informacija pogledajte Code of Conduct FAQ ili kontaktirajte opencode@microsoft.com za dodatna pitanja ili komentare.

📂 Struktura repozitorija

Repozitorij je organiziran na sljedeći način:

  • Core Curriculum (00-10): Glavni sadržaj organiziran u deset uzastopnih modula
  • images/: Dijagrami i ilustracije korišteni kroz cijeli kurikulum
  • translations/: Podrška za više jezika s automatskim prijevodima
  • translated_images/: Lokalizirane verzije dijagrama i ilustracija
  • study_guide.md: Sveobuhvatan vodič za snalaženje u repozitoriju
  • changelog.md: Evidencija svih značajnih promjena u materijalima kurikuluma
  • mcp.json: Konfiguracijska datoteka za MCP specifikaciju
  • CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Dokumenti upravljanja projektom

🎒 Ostali tečajevi

Naš tim izrađuje i druge tečajeve! Pogledajte:

™️ Obavijest o zaštitnom znaku

Ovaj projekt može sadržavati zaštitne znakove ili logotipe projekata, proizvoda ili usluga. Ovlaštena upotreba Microsoftovih zaštitnih znakova ili logotipa podliježe i mora se pridržavati Microsoftovih smjernica za zaštitne znakove i brendiranje. Korištenje Microsoftovih zaštitnih znakova ili logotipa u izmijenjenim verzijama ovog projekta ne smije izazvati zabunu niti implicirati sponzorstvo Microsofta. Svaka upotreba zaštitnih znakova ili logotipa trećih strana podliježe pravilima tih trećih strana.

Odricanje od odgovornosti:
Ovaj dokument je preveden korištenjem AI usluge za prevođenje Co-op Translator. Iako težimo točnosti, imajte na umu da automatski prijevodi mogu sadržavati pogreške ili netočnosti. Izvorni dokument na izvornom jeziku treba smatrati autoritativnim izvorom. Za kritične informacije preporučuje se profesionalni ljudski prijevod. Ne snosimo odgovornost za bilo kakve nesporazume ili pogrešna tumačenja koja proizlaze iz korištenja ovog prijevoda.