Skip to content

Latest commit

 

History

History
272 lines (178 loc) · 13.1 KB

README.md

File metadata and controls

272 lines (178 loc) · 13.1 KB

Praktická implementace

Praktická implementace je moment, kdy se síla Model Context Protocolu (MCP) stává hmatatelnou. Zatímco porozumění teorii a architektuře MCP je důležité, skutečná hodnota se ukáže, když tyto koncepty použijete k vytváření, testování a nasazování řešení, která řeší reálné problémy. Tato kapitola propojuje teoretické znalosti s 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 podnikový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 zpřístupňují MCP širokému spektru 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#, Javě, TypeScriptu, JavaScriptu a Pythonu. Naučíte se také, 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.

Přehled

Tato lekce se zaměřuje na praktické aspekty implementace MCP v různých programovacích jazycích. Prozkoumáme, jak používat MCP SDK v C#, Javě, TypeScriptu, JavaScriptu a Pythonu k vytváření robustních aplikací, ladění a testování MCP serverů a tvorbě znovupoužitelných zdrojů, promptů a nástrojů.

Cíle učení

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 (Resources, Prompts a Tools)
  • Navrhovat efektivní MCP workflow pro složité úkoly
  • Optimalizovat MCP implementace pro výkon a spolehlivost

Oficiální SDK zdroje

Model Context Protocol nabízí oficiální SDK pro několik jazyků:

Práce s MCP SDK

Tato sekce poskytuje praktické příklady implementace MCP v různých programovacích jazycích. Ukázkový kód najdete ve složce samples, uspořádaný podle jazyka.

Dostupné ukázky

Repositář obsahuje ukázkové implementace v těchto jazycích:

Každá ukázka demonstruje klíčové koncepty MCP a vzory implementace pro daný jazyk a ekosystém.

Základní funkce serveru

MCP servery mohou implementovat libovolnou kombinaci těchto funkcí:

Resources

Resources poskytují kontext a data, která uživatel nebo AI model může využít:

  • Repozitáře dokumentů
  • Znalostní báze
  • Strukturované datové zdroje
  • Soubory a souborové systémy

Prompts

Prompts jsou šablonované zprávy a workflow pro uživatele:

  • Předdefinované šablony konverzací
  • Řízené vzory interakce
  • Specializované dialogové struktury

Tools

Tools jsou funkce, které AI model může vykonávat:

  • Nástroje pro zpracování dat
  • Integrace s externími API
  • Výpočetní schopnosti
  • Vyhledávací funkce

Ukázkové implementace: C#

Oficiální repositář C# SDK 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 s registrací základních nástrojů
  • Pokročilý MCP server: Plnohodnotný 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 pro implementaci nástrojů s různou úrovní složitosti

MCP C# SDK je ve fázi preview a API se může měnit. Tento blog budeme průběžně aktualizovat podle vývoje SDK.

Klíčové funkce

Pro kompletní ukázky implementace v C# navštivte oficiální repositář C# SDK

Ukázková implementace: Java

Java SDK nabízí robustní možnosti implementace MCP s funkcemi na úrovni podniku.

Klíčové funkce

  • Integrace se Spring Frameworkem
  • Silná typová bezpečnost
  • Podpora reaktivního programování
  • Komplexní zpracování chyb

Pro kompletní ukázku implementace v Javě si prohlédněte Java sample ve složce samples.

Ukázková implementace: JavaScript

JavaScript SDK poskytuje lehký a flexibilní přístup k implementaci MCP.

Klíčové funkce

  • Podpora Node.js i 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 si prohlédněte JavaScript sample ve složce samples.

Ukázková implementace: Python

Python SDK nabízí pythonický přístup k implementaci MCP s vynikající integrací ML frameworků.

Klíčové funkce

  • 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 si prohlédněte Python sample ve složce samples.

Správa API

Azure API Management je skvělým řešením, jak zabezpečit MCP servery. Myšlenka je umístit instanci Azure API Management před váš MCP server a nechat ji spravovat funkce, které pravděpodobně budete chtít, jako jsou:

  • omezení rychlosti (rate limiting)
  • správa tokenů
  • monitorování
  • vyvažování zátěže
  • zabezpečení

Azure ukázka

Zde je Azure ukázka, která přesně toto dělá, tedy vytváří MCP server a zabezpečuje ho pomocí Azure API Management.

Podívejte se, jak probíhá autorizační proces na následujícím obrázku:

APIM-MCP

Na obrázku se děje 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.

Autorizační tok

Pojďme se podívat na autorizační tok podrobněji:

Sequence Diagram

Specifikace autorizace MCP

Více informací o specifikaci autorizace MCP

Nasazení vzdáleného MCP serveru do Azure

Podívejme se, jestli můžeme nasadit dříve zmíněný příklad:

  1. Naklonujte repozitář

    git clone https://github.com/Azure-Samples/remote-mcp-apim-functions-python.git
cd remote-mcp-apim-functions-python

  2. Zaregistrujte poskytovatele zdrojů 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. Po chvíli zkontrolujte stav registrace příkazem (Get-AzResourceProvider -ProviderNamespace Microsoft.App).RegistrationState.

  3. Spusťte tento příkaz azd pro vytvoření služby API Management, funkční aplikace (s kódem) a všech dalších potřebných Azure zdrojů

    azd up

    Tento příkaz by měl nasadit všechny cloudové zdroje na Azure.

Testování serveru pomocí MCP Inspector

  1. V novém terminálovém okně nainstalujte a spusťte MCP Inspector

    npx @modelcontextprotocol/inspector

    Měli byste vidět rozhraní podobné tomuto:

    Connect to Node inspector

  2. Klikněte s podržením CTRL pro načtení webové aplikace MCP Inspector z URL zobrazené aplikací (např. http://127.0.0.1:6274/#resources)

  3. Nastavte typ přenosu na SSE

  4. Nastavte URL na běžící API Management SSE endpoint zobrazený po příkazu azd up a klikněte na Connect:

    https://<apim-servicename-from-azd-output>.azure-api.net/mcp/sse

  5. Vypsat nástroje. Klikněte na nástroj a zvolte Run Tool.

Pokud vše proběhlo správně, měli byste být nyní připojeni k MCP serveru a úspěšně zavolat nástroj.

MCP servery pro Azure

Remote-mcp-functions: Tato sada repozitářů je rychlý startovací šablonou pro vytváření a nasazení vlastních vzdálených MCP (Model Context Protocol) serverů pomocí Azure Functions v Pythonu, C# .NET nebo Node/TypeScript.

Ukázky poskytují kompletní řešení, které umožňuje vývojářům:

  • Lokální vývoj a spuštění: Vyvíjet a ladit MCP server na lokálním počítači
  • Nasazení do Azure: Snadné nasazení do cloudu pomocí jednoduchého příkazu azd up
  • Připojení 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

Klíčové vlastnosti:

  • Bezpečnost od základu: MCP server je zabezpečen pomocí klíčů a HTTPS
  • Možnosti autentizace: Podpora OAuth s vestavěnou autentizací a/nebo API Managementem
  • 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í do Azure

Repozitář obsahuje všechny potřebné konfigurační soubory, zdrojový kód a definice infrastruktury, aby bylo možné rychle začít s produkčně připravenou implementací MCP serveru.

Hlavní poznatky

  • 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 promptů umožňují konzistentní interakce s AI
  • Dobře navržená workflow dokážou orchestraci složitých úkolů pomocí více nástrojů
  • Implementace MCP řešení vyžaduje zvážení bezpečnosti, výkonu a zpracování chyb

Cvičení

Navrhněte praktické MCP workflow, které řeší reálný problém ve vašem oboru:

  1. Identifikujte 3-4 nástroje, které by byly užitečné pro řešení tohoto problému
  2. Vytvořte diagram workflow, který ukazuje, jak tyto nástroje spolupracují
  3. Implementujte základní verzi jednoho z nástrojů ve vámi preferovaném jazyce
  4. Vytvořte šablonu promptu, která pomůže modelu efektivně využít váš nástroj

Další zdroje

Další: Pokročilá témata

Prohlášení o vyloučení odpovědnosti:
Tento dokument byl přeložen pomocí AI překladatelské služby Co-op Translator. I když usilujeme o přesnost, mějte prosím na paměti, že automatizované překlady mohou obsahovat chyby nebo nepřesnosti. Původní dokument v jeho mateřském jazyce by měl být považován za autoritativní zdroj. Pro důležité informace se doporučuje profesionální lidský překlad. Nejsme odpovědní za jakékoliv nedorozumění nebo nesprávné výklady vyplývající z použití tohoto překladu.