Skip to content

Latest commit

 

History

History
415 lines (292 loc) · 51.2 KB

File metadata and controls

415 lines (292 loc) · 51.2 KB

MCP-for-beginners

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome MCP Toplist

GitHub watchers GitHub forks GitHub stars

Microsoft Foundry Discord

Пратите ове кораке да бисте започели коришћење ових ресурса:

  1. Исцртај Репозиторијум (Fork the Repository): Кликните GitHub forks
  2. Клонирајте Репозиторијум (Clone the Repository): git clone https://github.com/microsoft/mcp-for-beginners.git
  3. Придружите се Microsoft Foundry Discord

🌐 Подршка за више језика

Подржано путем GitHub Action-а (Аутоматизовано и увек ажурирано)

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

Преферирате локално клонирање?

Овај репозиторијум укључује више од 50 превода језика што знатно повећава величину преузимања. Да бисте клонирали без превода, користите sparse checkout:

Bash / macOS / Linux:

git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git
cd mcp-for-beginners
git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'

CMD (Windows):

git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git
cd mcp-for-beginners
git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"

Ово вам даје све што је потребно за завршетак курса са знатно бржим преузимањем.

🚀 Програм учења за Model Context Protocol (MCP) за почетнике

Научите MCP са практичним примерима кода у C#, Java, JavaScript, Rust, Python, и TypeScript

🧠 Преглед програма учења Model Context Protocol-а

Добродошли на ваше путовање у Model Context Protocol! Ако сте се икада питали како AI апликације комуницирају са различитим алатима и услугама, управо ћете открити елегантно решење које трансформише начин на који програмери праве интелигентне системе.

Замислите MCP као универзални преводилац за AI апликације - баш као што USB портови дозвољавају повезивање било ког уређаја са рачунаром, MCP омогућава AI моделима да се прикључе било ком алату или услузи на стандардизован начин. Без обзира правите ли свој први chatbot или радите на комплексним AI токовима рада, разумевање MCP-а ће вам пружити моћ да креирате способније и флексибилније апликације.

Овај програм учења је осмишљен са стрпљењем и пажњом за ваше учење. Почећемо са једноставним концептима које већ разумете и постепено ћемо градити ваше вештине кроз практичну примену у вашем омиљеном програмском језику. Свак корак садржи јасна објашњења, практичне примере и пуно охрабрења током пута.

Када завршите ово путовање, имаћете самопоуздање да направите сопствене MCP сервере, интегришете их са популарним AI платформама и разумете како ова технологија обликује будућност развоја AI. Почнимо ову узбудљиву авантуру заједно!

Званична документација и спецификације

Тренутна ревизија протокола је MCP Specification 2026-07-28. MCP спецификација користи верзионисање засновано на датуму (формат ГГГГ-ММ-ДД) ради јасне компатибилности протокола.

Напомена о верзији: овај програм учења покрива тренутне 2026-07-28 концепте, укључујући бездржавне захтеве, Extensions оквир, и повлачење Roots, Sampling, и Logging. Неки практични примери су и даље експлицитно верзионисани на 2025-11-25 док SDK подршка не стигне. Погледајте Шта се променило у MCP: Спецификација 2026-07-28 за измене и смернице за миграцију.

Ови ресурси постају вреднији како ваше разумевање расте, али немојте се осећати притиснуто да све одмах прочитате. Почните са областима које вас највише занимају!

  • 📘 MCP документација – Ово је ваш главни ресурс за водиче корак по корак и корисничке водиче. Документација је написана с мислима на почетнике, пружајући јасне примере које можете пратити својим темпом.
  • 📜 MCP спецификација – Замислите ово као ваш свеобухватни референтни приручник. Док радите кроз програм учења, враћаћете се овде да проверите детаље и истражите напредне функције.
  • 📜 Верзионисање MCP спецификације – Ово садржи информације о историји верзионисања протокола и како MCP користи верзионисање засновано на датуму (формат ГГГГ-ММ-ДД).
  • 🧑‍💻 MCP GitHub репозиторијум – Овде ћете наћи SDK-ове, алате и примерке кода на више програмских језика. Као ризница практичних примера и компоненти спремних за употребу.
  • 🌐 МCP Заједница – Придружите се другим ученицима и искусним програмерима у дискусијама о MCP-у. То је подржавајућа заједница у којој су питања добродошла и знање се дели без ограничења.

Циљеви учења

До краја овог програма учења, осећаћете се сигурно и узбуђено због својих нових способности. Ево шта ћете постићи:

• Разумети основе MCP-а: Разумеваћете шта је Model Context Protocol и зашто он револуционише начин рада AI апликација заједно, користећи аналогиије и примере који имају смисла.

• Направити свој први MCP сервер: Направићете радни MCP сервер у свом омиљеном програмском језику, почевши са једноставним примерима и постепено развијајући своје вештине.

• Повезати AI моделе са стварним алатима: Научићете како да помоћу МCP-а повежете AI моделе са стварним услугама, дајући вашим апликацијама моћне нове могућности.

• Имплементирати најбоље безбедносне праксе: Разумећете како да обезбедите своје MCP имплементације, штитећи и апликације и кориснике.

• Успешно имплементирати пројекте: Знаћете како да извучете своје MCP пројекте из развоја до продукције, са практичним стратегијама за имплементацију које функционишу у реалном свету.

• Придружити се MCP заједници: Постаћете део растуће заједнице програмера који обликују будућност развоја AI апликација.

Неопходна Позадина

Пре него што зађемо у детаље MCP-а, хајде да се уверимо да се удобно осећате са неким основним концептима. Не брините ако нисте стручњак у овим областима - све ћемо објаснити како будемо напредовали!

Разумевање протокола (Основа)

Замислите протокол као правила за разговор. Када позовете пријатеља, обојице знате да треба да кажете „здраво“ када се јавите, да говорите наизмјенично и да кажете „ћао“ када завршите. Рачунарски програми требају слична правила да би ефикасно комуницирали.

MCP је протокол — скуп договорених правила који помажу AI моделима и апликацијама да воде продуктивне „разговоре“ са алатима и услугама. Баш као што правила за разговор чине људску комуникацију глаткијом, тако MCP чини комуникацију AI апликација много поузданијом и моћнијом.

Односи Клијент-Сервер (Како Програми ради Заједно)

Већ свакодневно користите односе клијент-сервер! Када користите веб прегледач (клијент) да посете веб сајт, повезујете се са веб сервером који вам шаље садржај странице. Прегледач зна како да затражи информацију, а сервер зна како да одговори.

У MCP-у имамо сличан однос: AI модели делују као клијенти који захтевају информације или радње, док MCP сервери пружају те могућности. Као да имате помоћног асистента (сервер) ког AI може замолити да обави одређене задатке.

Зашто је стандардизација важна (Како ствари раде Заједно)

Замислите да сваки произвођач аутомобила користи другачији облик пумпи за гориво — морали бисте имати различит адаптер за сваки ауто! Стандардизација значи договор о заједничким приступима како би ствари радиле беспрекорно заједно.

MCP пружа ову стандардизацију за AI апликације. Уместо да сваки AI модел треба посебан код за рад са сваким алатом, MCP ствара универзални начин за њихову комуникацију. То значи да програмери могу направити алате једном и да они раде са много различитих AI система.

🧭 Преглед вашег пута учења

Ваше путовање MCP-ом је пажљиво структуирано да постепено гради ваше самопоуздање и вештине. Свака фаза уводи нове концепте истовремено јачајући оно што сте већ научили.

🌱 Фаза Основе: Разумевање основа (Модули 0-2)

Овде почиње ваша авантура! Представићемо вам MCP концепте користећи познате аналогиије и једноставне примере. Разумећете шта је MCP, зашто постоји и како се уклапа у шири свет развоја AI.

• Модул 0 - Увод у MCP: Почећемо тако што ћемо истражити шта је MCP и зашто је толико важан за савремене AI апликације. Видећете примере MCP у акцији из реалног света и разумети како решава уобичајене проблеме са којима се програмери сусрећу.

• Модул 1 - Објашњење основних појмова: Овде ћете научити кључне концепте MCP. Користићемо мноштво аналогија и визуелних примера како бисмо осигурали да вам ови концепти буду природни и разумљиви.

• Модул 2 - Безбедност у MCP: Безбедност може звучати застрашујуће, али показаћемо вам како MCP укључује уграђене безбедносне функције и научити ћемо вас најбољим праксама које штите ваше апликације од самог почетка.

🔨 Фаза изградње: Креирање ваших првих имплементација (Модул 3)

Сада почиње права забава! Добићете праксу прављења стварних MCP сервера и клијената. Не брините – почећемо једноставно и водити вас кроз сваки корак.

Овај модул укључује више практичних водича који вам омогућавају вежбање у вашем омиљеном програмском језику. Креираћете свој први сервер, направити клијента који ће се повезати са њим и чак интегрисати са популарним развојним алатима као што је VS Code.

Сваки водич садржи потпуне примере кода, савете за решавање проблема и објашњења зашто правимо одређене дизајнерске изборе. На крају ове фазе имаћете функционалне MCP имплементације на које можете бити поносни!

🚀 Фаза раста: Напредни концепти и примена у стварном свету (Модули 4-5)

Када савладате основе, спремни сте да истражите сложеније функције MCP. Покрићемо практичне стратегије имплементације, технике дебаговања и напредне теме као што је мултимодална AI интеграција.

Такође ћете научити како да скалирате своје MCP имплементације за производну употребу и да интегришете са облачним платформама као што је Azure. Ови модули вас припремају да градите MCP решења која могу да поднесу захтеве стварног света.

🌟 Фаза мајсторства: Заједница и специјализација (Модули 6-11)

Последња фаза фокусира се на придруживање MCP заједници и специјализацију у областима које вас највише занимају. Научићете како да допринесете отвореним MCP пројектима, имплементирате напредне обрасце аутентификације и градите обимна решења интегрисана са базама података.

Модул 11 заслужује посебну пажњу - то је комплетан практичан пут учења са 13 лабораторијских вежби који вас учи како да правите MCP сервере припремљене за производњу са PostgreSQL интеграцијом. То је као завршни пројекат који спаја све што сте научили!

📚 Комплетна структура курса

Модул Тема Опис Веза
Модул 0-3: Основе
00 Увод у MCP Преглед Model Context Protocol и његов значај у AI пипелинима Прочитај више
01 Објашњење основних појмова Детаљно истраживање кључних MCP концепата Прочитај више
1.1 Шта се променила у MCP (2026-07-28) Бездржавни протокол, оквир проширења и укидања функција у текућој спецификацији Водич
02 Безбедност у MCP Безбедносне претње и најбоље праксе Прочитај више
2.1 CIMD и DCR ауторизација Упоредити пожељну CIMD регистрацију са застарелим DCR резервним методом користећи заштићени MCP сервер Пример
03 Почетак рада са MCP Подешавање окружења, основни сервери/клијенти, интеграција Прочитај више
Модул 3: Изградња вашег првог сервера и клијента
3.1 Први сервер Направите свој први MCP сервер Водич
3.2 Први клијент Развијте основни MCP клијент Водич
3.3 Клијент са LLM Интегришите велике језичке моделе Водич
3.4 VS Code интеграција Користите MCP сервере у VS Code-у Водич
3.5 stdio Сервер Креирајте сервере коришћењем stdio транспорта Водич
3.6 HTTP стриминг Имплементирајте HTTP стриминг у MCP Водич
3.7 Microsoft Foundry алат Користите Microsoft Foundry Toolkит са MCP Водич
3.8 Тестирање Тестирајте своју MCP сервера имплементацију Водич
3.9 Деплој Деплојирајте MCP сервере у производњу Водич
3.10 Напредна употреба сервера Користите напредне сервере за напредне функције и побољшану архитектуру Водич
3.11 Једноставна ауторизација Поглавље које вас учи аутентификацији од почетка и RBAC-у Водич
3.12 MCP хостови Конфигуришите Claude Desktop, Cursor, Cline и друге MCP хостове Водич
3.13 MCP Инспектор Дебагујте и тестирајте MCP сервере са алатом Инспектор Водич
3.14 Семплинг Користите семплинг за сарадњу са клијентом Водич
3.15 MCP апликације Градите MCP апликације Водич
Модул 4-5: Практично и напредно
04 Практична имплементација SDK-ови, дебаговање, тестирање, поновно коришћиви шаблони упита Прочитај више
4.1 Пагинација Рад са великим скупом резултата уз пагинацију на основу курсора Водич
05 Напредне теме у MCP Мултимодални AI, скалирање, употреба у предузећима Прочитај више
5.1 Azure интеграција MCP интеграција са Azure Водич
5.2 Мултимодалност Рад са више модалитета Водич
5.3 OAuth2 демонстрација Имплементација OAuth2 аутентификације Водич
5.4 Рут контексти Разумевање и имплементација рут контекста Водич
5.5 Роутинги MCP роутинг стратегије Водич
5.6 Семплинг Технике семплинга у MCP Водич
5.7 Скалирање Скалирање MCP имплементација Водич
5.8 Безбедност Напредне безбедносне разматрања Водич
5.9 Веб претрага Имплементација веб претраживачких могућности Водич
5.10 Стриминг у реалном времену Градите функционалност стримовања у реалном времену Водич
5.11 Претрага у реалном времену Имплементирајте претрагу у реалном времену Водич
5.12 Entra ID аутентификација Аутентификација са Microsoft Entra ID Водич
5.13 Foundry интеграција Интеграција са Microsoft Foundry Водич
5.14 Контекст инжењеринг Технике за ефикасан контекст инжењеринг Водич
5.15 MCP прилагођени транспорт Имплементације прилагођених транспорта Водич
5.16 Протоколне функције Обавештења о напретку, отказивање, шаблони ресурса Водич
5.17 Адверзеријални мулти-агент размисли Два агента расправљају супротне стране користећи заједничке MCP алате, оцењује их агент судија Водич
Модул 6-10: Заједница и најбоље праксе
06 Заједнички доприноси Како допринети MCP екосистему Водич
07 Увид из раног усвајања Приче из реалне имплементације Водич
08 Најбоље праксе за MCP Перформансе, отпорност на грешке, издржљивост Водич
09 MCP студије случаја Практични примери имплементације Водич
10 Практична радионица Изградња MCP сервера са Microsoft Foundry Toolkit-ом Лаб
Модул 11: MCP сервер практичне лабораторијске вежбе
11 MCP сервер интеграција са базом података Обухватан пут учења са 13 лабораторијских вежби за PostgreSQL интеграцију Лабс
11.1 Увод Преглед MCP са интеграцијом базе података и случајем употребе у малопродаји Лаб 00
11.2 Основна архитектура Разумевање архитектуре MCP сервера, слојева базе података и безбедносних образаца Лаб 01
11.3 Безбедност и мулти-тенантност Безбедност на нивоу реда, аутентификација и приступ подацима више корисника Лаб 02
11.4 Подешавање окружења Подешавање развојног окружења, Docker, Azure ресурси Лаб 03
11.5 Дизајн базе података Подешавање PostgreSQL-а, дизајн малопродајне шеме и пример података Лаб 04
11.6 Имплементација MCP сервера Градња FastMCP сервера са интеграцијом базе података Лаб 05
11.7 Развој алата Креирање алата за упите у базу и интроспекцију шеме Лаб 06
11.8 Семантичка претрага Имплементација векторских уградњи уз Azure OpenAI и pgvector Лаб 07
11.9 Тестирање и дебаговање Стратегије тестирања, алати за дебаговање и приступи валидацији Лаб 08
11.10 VS Code интеграција Конфигурисање VS Code MCP интеграције и коришћење AI Чета Лаб 09
11.11 Стратегије деплоја Docker деплој, Azure Container Apps и разматрања скалирања Лаб 10
11.12 Мониторинг Application Insights, логовање, праћење перформанси Лаб 11
11.13 Најбоље праксе Оптимизација перформанси, унапређење безбедности и савети за производњу Лаб 12
Модул 12: MCP алатке
12.1 Алатке Коришћење MCP у Copilot апликацији Водич

💻 Пројекти примерног кода

Један од најузбудљивијих делова учења MCP-а је праћење напретка ваших програмерских вештина. Дизајнирали смо наше примере кода тако да почну једноставно и постану сложенији како ваше разумевање буде дубље. Ево како уводимо концепте — са кодом који је лак за разумевање, али демонстрира праве MCP принципе, разумећете не само шта овај код ради, већ и зашто је структура таква и како се уклапа у веће MCP апликације.

Основни примери MCP калкулатора

Језик Опис Линк
C# MCP Сервер Пример Погледај код
Java MCP Калкулатор Погледај код
JavaScript MCP Демо Погледај код
Python MCP Сервер Погледај код
TypeScript MCP Пример Погледај код
Rust MCP Пример Погледај код

Напредне MCP Имплементације

Језик Опис Линк
C# Напредни Пример Погледај код
Java са Spring Пример Контејнер Апликације Погледај код
JavaScript Напредни Пример Погледај код
Python Комплексна Имплементација Погледај код
TypeScript Пример Контејнера Погледај код

🎯 Предуслови за учење MCP

Да бисте максимално искористили овај курикулум, требало би да имате:

  • Основно знање програмирања у барем једном од следећих језика: C#, Java, JavaScript, Python или TypeScript

  • Разумевање клијент-сервер модела и API-ја

  • Познавање REST и HTTP концепата

  • (Опционо) Позадина у AI/ML концептима

  • Учествовање у дискусијама наше заједнице ради подршке

📚 Водич за учење и ресурси

Ово репозиторијум укључује неколико ресурса који ће вам помоћи да ефикасно учите и пратите материјале:

Водич за учење

Доступан је свеобухватни Водич за учење који ће вам помоћи да се ефикасно крећете кроз овај репозиторијум. Ова визуелна карта курикулума показује како су сви теме повезане и пружа смернице како да користите примере пројеката на делотворан начин. Посебно је корисно ако сте визуелни ученик који воли да види целину.

Водич укључује:

  • Визуелну карту курикулума која приказује све покривене теме
  • Детаљну подршку сваком делу репозиторијума
  • Упутства како користити пример код пројекте
  • Препоручене путеве учења за различите нивое вештина
  • Додатне ресурсе који допуњују ваш процес учења

Листе промена

Одржавамо детаљан Листу промена која прати све важне ажурирања материјала курикулума, тако да можете бити у току са најновијим побољшањима и додатцима.

  • Додаци новог садржаја
  • Структурне промене
  • Побољшања карактеристика
  • Ажурирања документације

🛠️ Како ефикасно користити овај курикулум

Свако поглавље овог водича укључује:

  1. Јасна објашњења MCP концепата
  2. Примере кода уживо на више језика
  3. Вежбе за креирање правих MCP апликација
  4. Додатне ресурсе за напредне ученике

Погледајмо учење MCP са C# - серија туторијала

Учимо о Model Context Protocol-у (MCP), напредном оквиру дизајнираном да стандардује интеракције између AI модела и клијентских апликација. Кроз овај курс прилагођен почетницима, упознаћемо вас са MCP-ом и водити кроз креирање вашег првог MCP сервера.

🎓 Ваш MCP пут почиње

Честитамо! Управо сте направили први корак у узбудљивом путовању које ће проширити ваше програмерске способности и повезати вас са најнапреднијим развојем вештачке интелигенције.

Шта сте већ постигли

Читајући овај увод, већ сте почели да градите своју MCP основу знања. Разумете шта је MCP, зашто је важно и како ће овај курикулум подржати ваше учење. То је значајан успех и почетак ваше стручности у овој важној технологији.

Авантуре које следе

Док пролазите кроз модуле, сетите се да је сваки стручњак некада био почетник. Концепти који сада могу изгледати сложено, постаће друга природа како вежбате и примените их. Свaki мали корак гради моћне способности које ће вам служити током ваше развојне каријере.

Ваша мрежа подршке

Придружујете се заједници ученика и стручњака који су страствени о MCP-у и спремни да помогну другима да успеју. Без обзира да ли сте запели на изазову са кодом или сте узбуђени да поделите пробој, заједница је ту да подржи ваше путовање.

Ако запнете или имате питања о развоју AI апликација. Придружите се ученицима и искусним програмерима у дискусијама о MCP-у. То је подстицајна заједница где су питања добродошла и знање се слободно дели.

Microsoft Foundry Discord

Ако имате повратне информације о производу или грешке приликом развоја посетите:

Microsoft Foundry Developer Forum

Спремни за почетак?

Ваша MCP авантура почиње сада! Почните са Модулом 0 да зароните у своје прве практичне MCP искуства или истражите пример пројекате да видите шта ћете градити. Запамтите — сваки стручњак је почео управо тамо где сте ви сад, а уз стрпљење и праксу, бићете изненађени шта све можете постићи.

Добродошли у свет развоја Model Context Protocol-а. Хајде да заједно направимо нешто невероватно!

🤝 Допринос заједници учења

Овај курикулум јача доприносима ученика као што сте ви! Без обзира да ли исправљате типографску грешку, предлажете јасније објашњење или додате нови пример, ваши доприноси помажу другим почетницима да успеју.

Захваљујемо Microsoft Valued Professional-у Shivam Goyal на доприносу примерима кода.

Процес доприноса је осмишљен да буде пријатељски и подржавајући. Већина доприноса захтева Уговор о лиценци за допринос (CLA), али аутоматизовани алати ће вас глатко провести кроз процес.

📜 Отворено учење

Цео овај курикулум је доступан под MIT ЛИЦЕНЦОМ, што значи да га можете користити, модификовати и слободно делити. Ово подржава нашу мисију да знање о MCP учинимо доступним програмерима широм света.

🤝 Упутства за допринос

Овај пројекат поздравља доприносе и предлоге. Већина доприноса захтева да се сагласите са Уговором о лиценци за допринос (CLA) у коме изјављујете да имате право, и заиста дајете, права за коришћење вашег доприноса. За детаље посетите https://cla.opensource.microsoft.com.

Када пошаљете pull request, CLA бот ће аутоматски одредити да ли морате да доставите CLA и одговарајуће га означити (нпр., провера статуса, коментар). Једноставно пратите упутства која вам бот даје. Ово морате урадити само једном у свим репозиторијумима који користе наш CLA.

Овај пројекат је усвојио Microsoft Open Source Code of Conduct. За више информација погледајте Често постављана питања о Кодексу понашања или контактирајте opencode@microsoft.com за додатна питања или коментаре.


Спремни да започнете своје MCP путовање? Почните са Модул 00 - Увод у MCP и направите прве кораке у свет развоја Model Context Protocol-а!

🎒 Остали курсеви

Наш тим прави и друге курсеве! Погледајте:

LangChain

LangChain4j for Beginners LangChain.js for Beginners LangChain for Beginners

Azure / Edge / MCP / Agents

AZD for Beginners Edge AI for Beginners MCP for Beginners AI Agents for Beginners


Генеративна AI серија

Generative AI for Beginners Generative AI (.NET) Generative AI (Java) Generative AI (JavaScript)


Основно учење

ML for Beginners Data Science for Beginners

AI for Beginners Cybersecurity for Beginners Web Dev for Beginners IoT for Beginners XR Development for Beginners


Серјал Copilot

Copilot for AI Paired Programming Copilot for C#/.NET Copilot Adventure


Изјава о одрицању одговорности: Овај документ је преведен коришћењем услуге за аутоматски превод Co-op Translator. Иако тежимо тачности, имајте у виду да аутоматски преводи могу садржати грешке или нетачности. Оригинални документ на његовом изворном језику треба сматрати ауторитативним извором. За критичне информације препоручује се професионални људски превод. Нисмо одговорни за било каква неспоразума или погрешна тумачења која произилазе из коришћења овог превода.