Skip to content

Latest commit

 

History

History
399 lines (282 loc) · 50.4 KB

File metadata and controls

399 lines (282 loc) · 50.4 KB

MCP-for-beginners

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Foundry Discord

Пратите ове кораке да бисте почели да користите ове ресурсе:

  1. Направите форк репозиторијума: Кликните GitHub forks
  2. Клонирајте репозиторијум: git clone https://github.com/microsoft/mcp-for-beginners.git
  3. Придружите се Microsoft Foundry Discord

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

Подржано преко GitHub акције (аутоматска и увек ажурна)

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 моделима да се повежу са било којим алатом или сервисом на стандардизован начин. Без обзира да ли правите своју прву ћаскајућу машину или радите на сложеним AI токовима рада, разумевање MCP-а даће вам моћ да креирате способније и флексибилније апликације.

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

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

Службена документација и спецификације

Овај наставни програм је усклађен са MCP Спецификацијом 2025-11-25 (најновије стабилно издање). MCP спецификација користи верзионисање засновано на датуму (формат ГГГГ-ММ-ДД) како би обезбедила јасан преглед верзије протокола.

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

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

Циљеви учења

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

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

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

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

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

Обезбеђена примена у пракси: Знаћете како да развијете и примените MCP пројекте у продукцију са практичним стратегијама које раде у стварном свету.

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

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

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

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

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

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 заједници и специјализацију у областима које вас највише занимају. Научићете како да допринесете open-source MCP пројектима, имплементирате напредне обрасце аутентификације и градите свеобухватна решења интегрисана са базама података.

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

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

Модул Тема Опис Линк
Модул 0-3: Основе
00 Увод у MCP Преглед Model Context Protocol и његов значај у AI пипелинима Опширније
01 Објашњење основних појмова Дубинско истраживање основних MCP концепата Опширније
02 Безбедност у 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 Toolkit Користите Microsoft Foundry Toolkit са MCP Упутство
3.8 Тестирање Тестирајте своју MCP сервер имплементацију Упутство
3.9 Деплојмент Објавите MCP сервере у продукцију Упутство
3.10 Напредна употреба сервера Користите напредне сервере за напредне функције и побољшања архитектуре Упутство
3.11 Једноставна аутентификација Поглавље које вас учи аутентификацији од почетка и RBAC-у Упутство
3.12 MCP домаћини Конфигуришите Claude Desktop, Cursor, Cline и друге MCP домаћине Упутство
3.13 MCP инспектор Дијагностикујте и тестирајте MCP сервере помоћу алата Inspector Упутство
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 Root Contexts Разумевање и имплементација root контекста Упутство
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 Server Hands On Lab
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 интеграције и коришћење 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 пут почиње

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

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

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

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

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

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

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

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

Microsoft Foundry Discord

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

Microsoft Foundry Developer Forum

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

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

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

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

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

Захвалност Microsoft VП Shivam Goyal за допринос примерима кода.

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

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

Цео овај курикулум је доступан под MIT LICENSE, што значи да га можете користити, модификовати и делити слободно. То подржава нашу мисију да знање о MCP-у учинимо приступачним програмерима свуда.

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

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

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

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


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

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

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

LangChain

LangChain4j за почетнике LangChain.js за почетнике LangChain за почетнике

Azure / Edge / MCP / Agents

AZD за почетнике Edge AI за почетнике MCP за почетнике AI Agents за почетнике


Серия Генеративни AI

Генеративни AI за почетнике Генеративни AI (.NET) Генеративни AI (Java) Генеративни AI (JavaScript)


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

ML за почетнике Наука података за почетнике AI за почетнике Кибербезбедност за почетнике Веб развој за почетнике Интернет ствари за почетнике XR развој за почетнике


Серия Копилот

Копилот за везано програмерско дружење уз Вештачку интелигенцију Копилот за C#/.NET Копилот авантура


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