wehub/microsoft--mcp-for-beginners

Fork 0

Files

T

wehub-resource-sync c275ba2868 chore: import upstream snapshot with attribution

2026-07-13 13:31:35 +08:00

36 KiB

Raw Permalink Blame History

Postupujte podle těchto kroků, abyste začali používat tyto zdroje:

Vytvořte fork repozitáře: Klikněte na
Klonujte repozitář: git clone https://github.com/microsoft/mcp-for-beginners.git
Připojte se k

🌐 Podpora vícejazyčnosti

Podporováno pomocí GitHub Action (automatické & vždy aktuální)

Raději klonovat lokálně?

Tento repozitář obsahuje přes 50 překladů jazyků, což značně zvětšuje velikost stahování. Pro klonování bez překladů použijte 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"
To vám poskytne vše, co potřebujete k dokončení kurzu, a to s mnohem rychlejším stahováním.

🚀 Kurikulum Model Context Protocol (MCP) pro začátečníky

Naučte se MCP pomocí praktických příkladů v C#, Java, JavaScript, Rust, Python a TypeScript

🧠 Přehled kurikula Model Context Protocol

Vítejte na vaší cestě za Model Context Protocol! Pokud jste se někdy divili, jak AI aplikace komunikují s různými nástroji a službami, právě objevíte elegantní řešení, které mění způsob, jakým vývojáři vytvářejí inteligentní systémy.

Představte si MCP jako univerzální překladač pro AI aplikace – stejně jako USB porty umožňují připojit jakékoli zařízení k vašemu počítači, MCP umožňuje AI modelům připojit se ke kterémukoli nástroji nebo službě standardizovaným způsobem. Ať už vytváříte svého prvního chatbota, nebo pracujete na složitých AI pracovních postupech, pochopení MCP vám dá sílu vytvářet schopnější a flexibilnější aplikace.

Toto kurikulum je navrženo s trpělivostí a péčí o vaši vzdělávací cestu. Začneme se základními pojmy, kterým již rozumíte, a postupně vás provedeme ke zdokonalení prostřednictvím praktické výuky ve vašem oblíbeném programovacím jazyce. Každý krok obsahuje jasná vysvětlení, praktické příklady a spoustu povzbuzení na cestě.

Až dokončíte tuto cestu, budete mít sebevědomí vytvořit vlastní MCP servery, integrovat je s populárními AI platformami a pochopíte, jak tato technologie přetváří budoucnost vývoje AI. Pojďme společně začít toto vzrušující dobrodružství!

Oficiální dokumentace a specifikace

Toto kurikulum je v souladu s MCP Specification 2025-11-25 (nejnovější stabilní verzí). Specifikace MCP používá verzování založené na datu (formát RRRR-MM-DD) pro jasné sledování verzí protokolu.

Tyto zdroje získávají na hodnotě s tím, jak vaše znalosti rostou, ale necítíte se pod tlakem vše ihned číst. Začněte oblastmi, které vás zajímají nejvíce!

📘 MCP Dokumentace – Toto je váš primární zdroj pro krok za krokem tutoriály a uživatelské příručky. Dokumentace je napsána s ohledem na začátečníky a nabízí jasné příklady, které můžete sledovat vlastním tempem.
📜 MCP Specifikace – Považujte to za svůj komplexní referenční manuál. Během práce v kurikulu se sem budete vracet při hledání specifických detailů a zkoumání pokročilých funkcí.
📜 MCP Verze specifikace – Obsahuje informace o historii verzí protokolu a jak MCP používá verzování založené na datu (formát RRRR-MM-DD).
🧑‍💻 MCP GitHub repozitář – Zde najdete SDK, nástroje a ukázky kódu v několika programovacích jazycích. Je to jakýsi poklad praktických příkladů a komponent připravených k použití.
🌐 MCP Komunita – Připojte se k ostatním studentům a zkušeným vývojářům v diskuzích o MCP. Je to podpůrná komunita, kde jsou otázky vítány a znalosti volně sdíleny.

Výukové cíle

Na konci tohoto kurikula se budete cítit sebejistí a nadšení z vašich nových dovedností. Tady je, čeho dosáhnete:

• Porozumět základům MCP: Pochopíte, co je Model Context Protocol a proč revolučním způsobem mění spolupráci AI aplikací, pomocí přirovnání a příkladů, které dávají smysl.

• Vytvořit svůj první MCP server: Vytvoříte funkční MCP server v preferovaném programovacím jazyce, začnete s jednoduchými příklady a krok za krokem rozšíříte své schopnosti.

• Propojit AI modely s reálnými nástroji: Naučíte se, jak přemostit propast mezi AI modely a skutečnými službami, což vašim aplikacím poskytne nové silné schopnosti.

• Implementovat nejlepší bezpečnostní postupy: Pochopíte, jak udržet své MCP implementace bezpečné, chránit své aplikace i uživatele.

• Nasadit s jistotou: Budete vědět, jak přenést své MCP projekty z vývoje do produkce s praktickými nasazovacími strategiemi, které fungují v reálném světe.

• Připojit se ke komunitě MCP: Stanete se součástí rostoucí komunity vývojářů, kteří formují budoucnost vývoje AI aplikací.

Základní předpoklady

Než se ponoříme do specifik MCP, ujistěte se, že vám nejsou cizí některé základní pojmy. Nemusíte být expertem – vše vám vysvětlíme během cesty!

Porozumění protokolům (základ)

Představte si protokol jako pravidla pro konverzaci. Když voláte kamarádovi, oba víte, že se při přijetí pozdravíte, mluvíte střídavě a nakonec se rozloučíte. Počítačové programy potřebují podobná pravidla, aby si rozuměly.

MCP je protokol – sada dohodnutých pravidel, která pomáhají AI modelům a aplikacím vést smysluplné „konverzace“ s nástroji a službami. Stejně jako pravidla konverzace usnadňují lidskou komunikaci, MCP dělá komunikaci AI aplikací spolehlivější a výkonnější.

Klient-server vztahy (jak programy spolupracují)

Klient-server vztahy používáte každý den! Když používáte webový prohlížeč (klient) k návštěvě webu, připojujete se na webový server, který vám pošle obsah stránky. Prohlížeč ví, jak požádat o informace, a server ví, jak odpovědět.

V MCP máme podobný vztah: AI modely fungují jako klienti, kteří žádají o informace či akce, zatímco MCP servery tyto funkce poskytují. Je to jako mít pomocníka (server), kterého může AI požádat o provedení konkrétních úkolů.

Proč je standardizace důležitá (pro lepší spolupráci)

Představte si, že každý výrobce aut by používal jiný tvar benzinové pistole – potřebovali byste adaptér na každé auto! Standardizace znamená dohodnout se na společných postupech, aby věci fungovaly bez problémů spolu.

MCP poskytuje tuto standardizaci pro AI aplikace. Místo toho, aby každý AI model potřeboval vlastní kód pro každý nástroj, MCP vytváří univerzální způsob komunikace. Díky tomu mohou vývojáři vytvořit nástroje jednou a používat je s mnoha různými AI systémy.

🧭 Přehled vaší výukové cesty

Vaše MCP cesta je pečlivě strukturovaná tak, aby postupně budovala vaše sebevědomí a dovednosti. Každá fáze představuje nové koncepty a zároveň upevňuje již naučené.

🌱 Základní fáze: Porozumění základům (moduly 0–2)

Tady vaše dobrodružství začíná! Seznámíme vás s pojmy MCP pomocí známých přirovnání a jednoduchých příkladů. Pochopíte, co MCP je, proč existuje a jak zapadá do širšího světa vývoje AI.

• Modul 0 – Úvod do MCP: Začneme průzkumem, co MCP je a proč je důležité pro moderní AI aplikace. Uvidíte skutečné příklady MCP v praxi a pochopíte, jak vyřešit běžné problémy, s nimiž vývojáři bojují.

• Modul 1 – Vysvětlení základních konceptů: Zde se naučíte základní stavební kameny MCP. Použijeme spoustu přirovnání a vizuálních příkladů, aby tyto koncepty byly přirozené a snadno pochopitelné.

• Modul 2 – Bezpečnost v MCP: Bezpečnost může znít zastrašujícím dojmem, ale ukážeme vám, jak MCP obsahuje vestavěné bezpečnostní prvky a naučíme vás osvědčené postupy, které ochraňují vaše aplikace od začátku.

🔨 Fáze budování: Vytváření prvních implementací (modul 3)

Teď začíná ta pravá zábava! Získáte praktické zkušenosti s tvorbou skutečných MCP serverů a klientů. Nebojte se – začneme jednoduše a provedeme vás každým krokem.

Tento modul obsahuje několik praktických průvodců, které vám umožní cvičit ve vámi preferovaném programovacím jazyce. Vytvoříte svůj první server, postavíte klienta pro připojení k němu a dokonce se naučíte integrovat s populárními vývojářskými nástroji, jako je VS Code.

Každý průvodce obsahuje kompletní příklady kódu, tipy pro řešení problémů a vysvětlení, proč volíme určité návrhové volby. Na konci této fáze budete mít funkční implementace MCP, na které můžete být hrdí!

🚀 Fáze růstu: Pokročilé koncepty a reálné použití (moduly 4-5)

Po zvládnutí základů jste připraveni objevovat sofistikovanější funkce MCP. Pokryjeme praktické implementační strategie, techniky ladění a pokročilá témata jako integrace multimodální AI.

Naučíte se také škálovat své implementace MCP pro produkční použití a integrovat je s cloudovými platformami, jako je Azure. Tyto moduly vás připraví na vytváření MCP řešení, která zvládnou požadavky reálného světa.

🌟 Fáze mistrovství: Komunita a specializace (moduly 6-11)

Závěrečná fáze se zaměřuje na zapojení do komunity MCP a specializaci na oblasti, které vás zajímají nejvíce. Naučíte se, jak přispívat do open-source MCP projektů, implementovat pokročilé autentizační vzory a budovat komplexní řešení integrovaná s databázemi.

Modul 11 si zaslouží zvláštní zmínku – je to kompletní 13-laboratorní praktická učební cesta, která vás naučí vytvářet MCP servery připravené na produkci s integrací PostgreSQL. Je to jako závěrečný projekt, který propojuje vše, co jste se naučili!

📚 Kompletní struktura kurikula

Modul	Téma	Popis	Odkaz
Moduly 0-3: Základy
00	Úvod do MCP	Přehled Model Context Protocol a jeho význam v AI pipelinech	Číst více
01	Vysvětlení základních konceptů	Hloubkový průzkum klíčových MCP konceptů	Číst více
02	Bezpečnost v MCP	Hrozby zabezpečení a nejlepší postupy	Číst více
03	Začínáme s MCP	Nastavení prostředí, základní servery/klienti, integrace	Číst více
Modul 3: Vytvoření vašeho prvního serveru a klienta
3.1	První server	Vytvořte svůj první MCP server	Průvodce
3.2	První klient	Vyvíjejte základního MCP klienta	Průvodce
3.3	Klient s LLM	Integrace velkých jazykových modelů	Průvodce
3.4	Integrace s VS Code	Používání MCP serverů ve VS Code	Průvodce
3.5	stdio server	Vytvoření serverů pomocí stdio transportu	Průvodce
3.6	HTTP streamování	Implementace HTTP streamování v MCP	Průvodce
3.7	Microsoft Foundry Toolkit	Použití Microsoft Foundry Toolkit s MCP	Průvodce
3.8	Testování	Testování vaší MCP serverové implementace	Průvodce
3.9	Nasazení	Nasazení MCP serverů do produkce	Průvodce
3.10	Pokročilé používání serveru	Používání pokročilých serverů pro pokročilé funkce a lepší architekturu	Průvodce
3.11	Jednoduchá autentizace	Kapitola věnovaná autentizaci od základů a RBAC	Průvodce
3.12	MCP hosté	Konfigurace Claude Desktop, Cursor, Cline a dalších MCP hostů	Průvodce
3.13	MCP Inspector	Ladění a testování MCP serverů pomocí nástroje Inspector	Průvodce
3.14	Sampling	Použití sampling pro spolupráci s klientem	Průvodce
3.15	MCP aplikace	Tvorba MCP aplikací	Průvodce
Moduly 4-5: Praktické a pokročilé
04	Praktické implementace	SDK, ladění, testování, znovupoužitelné šablony promptů	Číst více
4.1	Stránkování	Řešení velkých množin výsledků pomocí kurzorového stránkování	Průvodce
05	Pokročilá témata v MCP	Multimodální AI, škálování, podnikové použití	Číst více
5.1	Integrace Azure	MCP integrace s Azure	Průvodce
5.2	Multimodalita	Práce s více modality	Průvodce
5.3	Demo OAuth2	Implementace autentizace OAuth2	Průvodce
5.4	Root Contexty	Pochopení a implementace root kontextů	Průvodce
5.5	Směrování	MCP směrovací strategie	Průvodce
5.6	Sampling	Sampling techniky v MCP	Průvodce
5.7	Škálování	Škálování MCP implementací	Průvodce
5.8	Bezpečnost	Pokročilé bezpečnostní úvahy	Průvodce
5.9	Webové vyhledávání	Implementace funkcí webového vyhledávání	Průvodce
5.10	Real-time streamování	Vytváření funkcionality real-time streamování	Průvodce
5.11	Real-time vyhledávání	Implementace real-time vyhledávání	Průvodce
5.12	Entra ID autentizace	Autentizace s Microsoft Entra ID	Průvodce
5.13	Integrace Foundry	Integrace s Microsoft Foundry	Průvodce
5.14	Context Engineering	Techniky pro efektivní kontextové inženýrství	Průvodce
5.15	Vlastní MCP transport	Implementace vlastních transportů	Průvodce
5.16	Funkce protokolu	Notifikace průběhu, zrušení, šablony zdrojů	Průvodce
5.17	Adversariální multi-agentní uvažování	Dva agenti argumentují protichůdné strany pomocí sdílených MCP nástrojů, hodnocení agentem rozhodčím	Průvodce
Moduly 6-10: Komunita a osvědčené postupy
06	Příspěvky komunity	Jak přispívat do MCP ekosystému	Průvodce
07	Postřehy z raného zavádění	Příběhy reálných implementací	Průvodce
08	Osvědčené praktiky pro MCP	Výkon, odolnost vůči chybám, rezilience	Průvodce
09	MCP případové studie	Praktické příklady implementací	Průvodce
10	Praktický workshop	Stavba MCP serveru s Microsoft Foundry Toolkit	Laboratoř
Modul 11: Praktická laboratoř MCP serveru
11	Integrace MCP serveru s databází	Komplexní 13-laboratorní praktická učební cesta pro integraci PostgreSQL	Laboratoře
11.1	Úvod	Přehled MCP s integrací databáze a případ použití v retailové analytice	Laboratoř 00
11.2	Základní architektura	Pochopení architektury MCP serveru, databázových vrstev a bezpečnostních vzorů	Laboratoř 01
11.3	Bezpečnost a multi-tenancy	Bezpečnost na úrovni řádků, autentizace a přístup k datům více nájemců	Laboratoř 02
11.4	Nastavení prostředí	Nastavení vývojového prostředí, Docker, Azure zdroje	Laboratoř 03
11.5	Návrh databáze	Nastavení PostgreSQL, návrh retailového schématu a ukázková data	Laboratoř 04
11.6	Implementace MCP serveru	Stavba FastMCP serveru s integrací databáze	Laboratoř 05
11.7	Vývoj nástrojů	Tvorba nástrojů pro dotazy do databáze a introspekce schématu	Laboratoř 06
11.8	Sémantické vyhledávání	Implementace vektorových embeddingů s Azure OpenAI a pgvector	Laboratoř 07
11.9	Testování a ladění	Strategie testování, ladicí nástroje a validační přístupy	Laboratoř 08
11.10	Integrace VS Code	Konfigurace VS Code integrace MCP a používání AI chatu	Laboratoř 09
11.11	Strategie nasazení	Nasazení s Dockerem, Azure Container Apps a úvahy o škálování	Laboratoř 10
11.12	Monitoring	Application Insights, logování, sledování výkonu	Laboratoř 11
11.13	Nejlepší praktiky	Optimalizace výkonu, zabezpečení a tipy pro produkci	Laboratoř 12
Modul 12: MCP nástroje
12.1	Nástroje	Použití MCP v aplikaci Copilot	Průvodce

💻 Ukázkové projekty kódu

Jedna z nejzajímavějších částí učení MCP je vidět, jak se vaše schopnosti v kódování postupně rozvíjejí. Navrhli jsme naše ukázky kódu tak, aby začínaly jednoduše a postupně byly náročnější, jak vaše porozumění roste. Takto zavádíme koncepty – s kódem, který je snadné pochopit, ale demonstruje skutečné MCP principy, pochopíte nejen to, co tento kód dělá, ale také proč je strukturován tímto způsobem a jak zapadá do větších MCP aplikací.

Základní MCP kalkulačky – ukázky

Jazyk	Popis	Odkaz
C#	MCP server – příklad	Zobrazit kód
Java	MCP kalkulačka	Zobrazit kód
JavaScript	MCP demo	Zobrazit kód
Python	MCP server	Zobrazit kód
TypeScript	MCP příklad	Zobrazit kód
Rust	MCP příklad	Zobrazit kód

Pokročilé MCP implementace

Jazyk	Popis	Odkaz
C#	Pokročilá ukázka	Zobrazit kód
Java se Springem	Příklad Container App	Zobrazit kód
JavaScript	Pokročilý příklad	Zobrazit kód
Python	Složitá implementace	Zobrazit kód
TypeScript	Příklad Container	Zobrazit kód

🎯 Předpoklady pro studium MCP

Abyste z tohoto kurikula vytěžili co nejvíc, měli byste mít:

Základní znalosti programování alespoň v jednom z následujících jazyků: C#, Java, JavaScript, Python nebo TypeScript
Pochopení klient-server modelu a API
Seznámení s koncepty REST a HTTP
(Volitelné) Zázemí v konceptech AI/ML
Účast v našich komunitních diskuzích pro podporu

📚 Studijní průvodce a zdroje

Tento repozitář obsahuje několik zdrojů, které vám pomohou efektivně se orientovat a učit:

Studijní průvodce

Komplexní Studijní průvodce je k dispozici, aby vám pomohl efektivně se orientovat v tomto repozitáři. Tento vizuální mapový přehled kurikula ukazuje, jak jsou všechna témata propojena, a poskytuje návod, jak efektivně využívat vzorové projekty. Je zvláště užitečný, pokud jste vizuální typ, který rád vidí celý obrázek.

Průvodce obsahuje:

Vizuální mapu kurikula zobrazující všechna pokrytá témata
Podrobný rozbor jednotlivých částí repozitáře
Pokyny k využití vzorových projektů
Doporučené učební cesty pro různé úrovně dovedností
Další zdroje pro doplnění vaší učební cesty

Změny

Udržujeme podrobný seznam změn, který sleduje všechny významné aktualizace studijních materiálů, abyste byli vždy aktuální s nejnovějšími vylepšeními a doplňky.

Přidání nového obsahu
Strukturální změny
Vylepšení funkcí
Aktualizace dokumentace

🛠️ Jak efektivně používat toto kurikulum

Každá lekce v tomto průvodci obsahuje:

Jasná vysvětlení konceptů MCP
Příklady kódu živě v několika jazycích
Cvičení pro tvorbu skutečných aplikací MCP
Další zdroje pro pokročilé studenty

Naučme se MCP s C# - série tutoriálů

Naučme se Model Context Protocol (MCP), moderní rámec určený ke standardizaci interakcí mezi AI modely a klientskými aplikacemi. V této úvodní přátelské lekci vám představíme MCP a provedeme vás vytvořením vašeho prvního MCP serveru.

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

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

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

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

🎓 Vaše cesta MCP začíná

Gratulujeme! Právě jste udělali první krok na vzrušující cestě, která rozšíří vaše programátorské schopnosti a připojí vás k špičce vývoje AI.

Co jste již zvládli

Pročtením tohoto úvodu jste již začali budovat svůj základ znalostí MCP. Rozumíte tomu, co je MCP, proč je důležitý a jak vám toto kurikulum pomůže na vaší učební cestě. To je významný úspěch a začátek vaší odbornosti v této důležité technologii.

Dobrodružství před vámi

Jak budete postupovat moduly, pamatujte, že každý expert byl jednou začátečník. Koncepty, které se nyní zdají složité, se vám stanou samozřejmostí, když je budete cvičit a aplikovat. Každý malý krok buduje silné dovednosti, které vám budou sloužit po celou vaši kariéru vývojáře.

Vaše podpůrná síť

Připojujete se ke komunitě studentů a odborníků, kteří mají vášeň pro MCP a rádi pomáhají druhým uspět. Ať už uvíznete na nějakém kódovacím úkolu, nebo se chcete podělit o průlomový úspěch, komunita je tu, aby vám pomohla na vaší cestě.

Pokud budete mít potíže nebo otázky ohledně tvorby AI aplikací, připojte se k ostatním studentům a zkušeným vývojářům v diskuzích o MCP. Je to podpůrná komunita, kde jsou otázky vítány a znalosti se sdílejí zdarma.

Pokud máte zpětnou vazbu k produktu nebo chyby při vývoji, navštivte:

Jste připraveni začít?

Vaše cesta MCP začíná právě teď! Začněte Modul 0 a ponořte se do svých prvních praktických zkušeností s MCP, nebo prozkoumejte vzorové projekty a podívejte se, co budete tvořit. Pamatujte – každý expert začínal přesně tam, kde jste vy, a s trpělivostí a praxí budete ohromeni, čeho můžete dosáhnout.

Vítejte ve světě vývoje Model Context Protocol. Postavme společně něco úžasného!

🤝 Přispívání do učební komunity

Toto kurikulum sílí díky přispěvatelům jako jste vy! Ať už opravujete překlep, navrhujete jasnější vysvětlení nebo přidáváte nový příklad, vaše příspěvky pomáhají dalším začátečníkům uspět.

Děkujeme Microsoft Valued Professional Shivam Goyal za přispění ukázkových kódů.

Proces přispívání je navržen tak, aby byl přívětivý a podpůrný. Většina příspěvků vyžaduje Contributor License Agreement (CLA), ale automatizované nástroje vás hladce provedou procesem.

📜 Otevřené učení

Celé toto kurikulum je dostupné pod licencí MIT LICENSE, což znamená, že ho můžete používat, upravovat a volně sdílet. To podporuje naši misi zpřístupnit znalosti MCP všem vývojářům všude.

🤝 Pravidla přispívání

Tento projekt vítá příspěvky a návrhy. Většina příspěvků vyžaduje váš souhlas s Contributor License Agreement (CLA), kterým prohlašujete, že máte právo a skutečně udělujete práva na použití vašeho příspěvku. Podrobnosti najdete na https://cla.opensource.microsoft.com.

Při odesílání pull requestu automaticky CLA bot určí, zda musíte poskytnout CLA a podle toho označí PR (např. kontrola stavu, komentář). Postupujte podle pokynů bota. Toto budete muset udělat jen jednou napříč všemi repozitáři používajícími naše CLA.

Tento projekt přijal Microsoft Open Source Code of Conduct. Pro více informací viz Code of Conduct FAQ nebo kontaktujte opencode@microsoft.com s jakýmikoli dalšími dotazy nebo připomínkami.

Připraveni začít svou cestu MCP? Začněte s Module 00 - Úvod do MCP a udělejte své první kroky ve světě vývoje Model Context Protocol!

🎒 Ostatní kurzy

Náš tým také vytváří další kurzy! Podívejte se na:

LangChain

Azure / Edge / MCP / Agenti

Generativní AI série

Základní výuka

Séria Copilot

Prohlášení o omezení odpovědnosti: Tento dokument byl přeložen pomocí AI překladatelské služby Co-op Translator. Přestože usilujeme o co největší přesnost, mějte prosím na paměti, že automatizované překlady mohou obsahovat chyby nebo nepřesnosti. Originální dokument v jeho mateřském jazyce by měl být považován za autoritativní zdroj. Pro kritické informace se doporučuje profesionální lidský překlad. Nejsme odpovědní za jakékoli nedorozumění nebo nesprávné interpretace vzniklé použitím tohoto překladu.

36 KiB Raw Permalink Blame History Unescape Escape