(Klikněte na obrázek výše pro zhlédnutí videa této lekce)
Praktická implementace je místem, kde se síla Model Context Protocolu (MCP) stává hmatatelnou. Zatímco pochopení teorie a architektury MCP je důležité, skutečná hodnota se projeví, když tyto koncepty aplikujete k vytváření, testování a nasazování řešení, která řeší reálné problémy. Tato kapitola překonává propast mezi teoretickými znalostmi a praktickým vývojem a provede vás procesem oživení aplikací založených na MCP.
Ať už vyvíjíte inteligentní asistenty, integrujete AI do obchodních procesů nebo vytváříte vlastní nástroje pro zpracování dat, MCP poskytuje flexibilní základ. Jeho jazykově nezávislý design a oficiální SDK pro populární programovací jazyky jej činí přístupným pro širokou škálu vývojářů. Díky těmto SDK můžete rychle prototypovat, iterovat a škálovat svá řešení napříč různými platformami a prostředími.
V následujících sekcích najdete praktické příklady, ukázkový kód a strategie nasazení, které demonstrují, jak implementovat MCP v C#, Java se Springem, TypeScriptu, JavaScriptu a Pythonu. Také se naučíte, jak ladit a testovat MCP servery, spravovat API a nasazovat řešení do cloudu pomocí Azure. Tyto praktické zdroje jsou navrženy tak, aby urychlily vaše učení a pomohly vám s jistotou vytvářet robustní, produkčně připravené MCP aplikace.
Tato lekce se zaměřuje na praktické aspekty implementace MCP napříč různými programovacími jazyky. Prozkoumáme, jak používat MCP SDK v C#, Java se Springem, TypeScriptu, JavaScriptu a Pythonu k vytváření robustních aplikací, ladění a testování MCP serverů a vytváření znovupoužitelných zdrojů, šablon a nástrojů.
Na konci této lekce budete schopni:
- Implementovat MCP řešení pomocí oficiálních SDK v různých programovacích jazycích
- Systematicky ladit a testovat MCP servery
- Vytvářet a používat funkce serveru (Zdroje, Šablony a Nástroje)
- Navrhovat efektivní MCP pracovní postupy pro složité úkoly
- Optimalizovat implementace MCP pro výkon a spolehlivost
Model Context Protocol nabízí oficiální SDK pro více jazyků:
- C# SDK
- Java se Springem SDK Poznámka: vyžaduje závislost na Project Reactor. (Viz diskusní téma 246.)
- TypeScript SDK
- Python SDK
- Kotlin SDK
Tato sekce poskytuje praktické příklady implementace MCP napříč různými programovacími jazyky. Ukázkový kód najdete ve složce samples, která je organizována podle jazyka.
Repozitář obsahuje ukázkové implementace v následujících jazycích:
Každá ukázka demonstruje klíčové koncepty MCP a vzory implementace pro daný jazyk a ekosystém.
MCP servery mohou implementovat libovolnou kombinaci těchto funkcí:
Zdroje poskytují kontext a data pro uživatele nebo AI model:
- Repozitáře dokumentů
- Znalostní báze
- Strukturované datové zdroje
- Systémy souborů
Šablony jsou předdefinované zprávy a pracovní postupy pro uživatele:
- Předem definované šablony konverzací
- Vedené vzory interakce
- Specializované struktury dialogů
Nástroje jsou funkce, které může AI model vykonávat:
- Nástroje pro zpracování dat
- Integrace externích API
- Výpočetní schopnosti
- Funkce vyhledávání
Oficiální C# SDK repozitář obsahuje několik ukázkových implementací, které demonstrují různé aspekty MCP:
- Základní MCP klient: Jednoduchý příklad, jak vytvořit MCP klienta a volat nástroje
- Základní MCP server: Minimální implementace serveru se základní registrací nástrojů
- Pokročilý MCP server: Plně vybavený server s registrací nástrojů, autentizací a zpracováním chyb
- Integrace s ASP.NET: Příklady integrace s ASP.NET Core
- Vzory implementace nástrojů: Různé vzory implementace nástrojů s různou úrovní složitosti
C# SDK pro MCP je ve fázi preview a API se mohou měnit. Tento blog budeme průběžně aktualizovat, jakmile se SDK vyvíjí.
- C# MCP Nuget ModelContextProtocol
- Vytvoření vašeho prvního MCP serveru.
Pro kompletní ukázky implementace v C# navštivte oficiální repozitář ukázek C# SDK.
SDK pro Java se Springem nabízí robustní možnosti implementace MCP s funkcemi na úrovni podniku.
- Integrace s frameworkem Spring
- Silná typová bezpečnost
- Podpora reaktivního programování
- Komplexní zpracování chyb
Pro kompletní ukázku implementace v Java se Springem viz Java se Springem ukázka ve složce ukázek.
SDK pro JavaScript poskytuje lehký a flexibilní přístup k implementaci MCP.
- Podpora Node.js a prohlížeče
- API založené na Promise
- Snadná integrace s Express a dalšími frameworky
- Podpora WebSocket pro streamování
Pro kompletní ukázku implementace v JavaScriptu viz JavaScript ukázka ve složce ukázek.
SDK pro Python nabízí Pythonický přístup k implementaci MCP s vynikající integrací ML frameworků.
- Podpora async/await s asyncio
- Integrace s FastAPI
- Jednoduchá registrace nástrojů
- Nativní integrace s populárními ML knihovnami
Pro kompletní ukázku implementace v Pythonu viz Python ukázka ve složce ukázek.
Azure API Management je skvělou odpovědí na otázku, jak zabezpečit MCP servery. Myšlenkou je umístit instanci Azure API Management před váš MCP server a nechat ji spravovat funkce, které pravděpodobně budete chtít, jako například:
- omezení rychlosti
- správa tokenů
- monitorování
- vyvažování zátěže
- zabezpečení
Zde je Azure ukázka, která přesně tohle dělá, tj. vytvoření MCP serveru a jeho zabezpečení pomocí Azure API Management.
Podívejte se, jak probíhá autorizační tok na obrázku níže:
Na předchozím obrázku probíhá následující:
- Autentizace/autorizace probíhá pomocí Microsoft Entra.
- Azure API Management funguje jako brána a používá politiky k řízení a správě provozu.
- Azure Monitor zaznamenává všechny požadavky pro další analýzu.
Podívejme se na autorizační tok podrobněji:
Více informací o specifikaci autorizace MCP.
Podívejme se, zda můžeme nasadit ukázku, kterou jsme zmínili dříve:
-
Naklonujte repozitář
git clone https://github.com/Azure-Samples/remote-mcp-apim-functions-python.git cd remote-mcp-apim-functions-python -
Zaregistrujte poskytovatele prostředků
Microsoft.App.- Pokud používáte Azure CLI, spusťte
az provider register --namespace Microsoft.App --wait. - Pokud používáte Azure PowerShell, spusťte
Register-AzResourceProvider -ProviderNamespace Microsoft.App. Poté po chvíli spusťte(Get-AzResourceProvider -ProviderNamespace Microsoft.App).RegistrationState, abyste ověřili, zda je registrace dokončena.
- Pokud používáte Azure CLI, spusťte
-
Spusťte tento příkaz azd pro zajištění služby správy API, funkční aplikace (s kódem) a všech dalších potřebných Azure prostředků:
azd up
Tento příkaz by měl nasadit všechny cloudové prostředky na Azure.
-
V novém terminálovém okně nainstalujte a spusťte MCP Inspector:
npx @modelcontextprotocol/inspector
Měli byste vidět rozhraní podobné tomuto:
-
CTRL klikněte pro načtení webové aplikace MCP Inspector z URL zobrazené aplikací (např. http://127.0.0.1:6274/#resources).
-
Nastavte typ přenosu na
SSE. -
Nastavte URL na váš běžící API Management SSE endpoint zobrazený po
azd upa Připojte se:https://<apim-servicename-from-azd-output>.azure-api.net/mcp/sse
-
Seznam nástrojů. Klikněte na nástroj a Spusťte nástroj.
Pokud všechny kroky proběhly úspěšně, měli byste být nyní připojeni k MCP serveru a mohli jste zavolat nástroj.
Remote-mcp-functions: Tato sada repozitářů je rychlým startovacím šablonou pro vytváření a nasazování vlastních vzdálených MCP (Model Context Protocol) serverů pomocí Azure Functions s Pythonem, C# .NET nebo Node/TypeScript.
Ukázky poskytují kompletní řešení, které umožňuje vývojářům:
- Vytvářet a spouštět lokálně: Vyvíjet a ladit MCP server na lokálním stroji
- Nasazovat na Azure: Snadno nasazovat do cloudu pomocí jednoduchého příkazu
azd up - Připojovat se z klientů: Připojit se k MCP serveru z různých klientů včetně režimu agenta Copilot ve VS Code a nástroje MCP Inspector
- Zabezpečení od návrhu: MCP server je zabezpečen pomocí klíčů a HTTPS
- Možnosti autentizace: Podpora OAuth pomocí vestavěné autentizace a/nebo správy API
- Izolace sítě: Umožňuje izolaci sítě pomocí Azure Virtual Networks (VNET)
- Serverless architektura: Využívá Azure Functions pro škálovatelné, událostmi řízené provádění
- Lokální vývoj: Komplexní podpora lokálního vývoje a ladění
- Jednoduché nasazení: Zjednodušený proces nasazení na Azure
Repozitář obsahuje všechny potřebné konfigurační soubory, zdrojový kód a definice infrastruktury pro rychlý začátek s produkčně připravenou implementací MCP serveru.
-
Azure Remote MCP Functions Python - Ukázková implementace MCP pomocí Azure Functions s Pythonem.
-
Azure Remote MCP Functions .NET - Ukázková implementace MCP pomocí Azure Functions s C# .NET.
-
Azure Remote MCP Functions Node/Typescript - Ukázková implementace MCP pomocí Azure Functions s Node/TypeScript.
- MCP SDK poskytují jazykově specifické nástroje pro implementaci robustních MCP řešení.
- Proces ladění a testování je klíčový pro spolehlivé MCP aplikace.
- Znovupoužitelné šablony umožňují konzistentní AI interakce.
- Dobře navržené pracovní postupy mohou orchestrálně řešit složité úkoly pomocí více nástrojů.
- Implementace MCP řešení vyžaduje zvážení bezpečnosti, výkonu a zpracování chyb.
Navrhněte praktický MCP pracovní postup, který řeší reálný problém ve vašem oboru:
- Identifikujte 3-4 nástroje, které by byly užitečné pro řešení tohoto problému.
- Vytvořte diagram pracovního postupu, který ukazuje, jak tyto nástroje spolupracují.
- Implementujte základní verzi jednoho z nástrojů pomocí vašeho preferovaného jazyka.
- Vytvořte šablonu, která by modelu pomohla efektivně používat váš nástroj.
Další: Pokročilá témata
Prohlášení:
Tento dokument byl přeložen pomocí služby pro automatický překlad Co-op Translator. I když se snažíme o co největší přesnost, mějte prosím na paměti, že automatické překlady mohou obsahovat chyby nebo nepřesnosti. Původní dokument v jeho původním jazyce by měl být považován za závazný zdroj. Pro důležité informace doporučujeme profesionální lidský překlad. Neodpovídáme za žádná nedorozumění nebo nesprávné výklady vyplývající z použití tohoto překladu.