(Kliknite na obrázok vyššie pre zobrazenie videa k tejto lekcii)
Praktická implementácia je miesto, kde sa sila Model Context Protocol (MCP) stáva hmatateľnou. Zatiaľ čo pochopenie teórie a architektúry MCP je dôležité, skutočná hodnota sa prejaví, keď tieto koncepty aplikujete na vytváranie, testovanie a nasadzovanie riešení, ktoré riešia reálne problémy. Táto kapitola prepojí medzeru medzi konceptuálnymi vedomosťami a praktickým vývojom, pričom vás prevedie procesom oživovania aplikácií založených na MCP.
Či už vyvíjate inteligentných asistentov, integrujete AI do obchodných pracovných postupov alebo vytvárate vlastné nástroje na spracovanie dát, MCP poskytuje flexibilný základ. Jeho jazykovo nezávislý dizajn a oficiálne SDK pre populárne programovacie jazyky ho robia prístupným pre široké spektrum vývojárov. Využitím týchto SDK môžete rýchlo prototypovať, iterovať a škálovať svoje riešenia naprieč rôznymi platformami a prostrediami.
V nasledujúcich sekciách nájdete praktické príklady, ukážkový kód a stratégie nasadzovania, ktoré demonštrujú, ako implementovať MCP v C#, Java so Spring, TypeScript, JavaScript a Python. Naučíte sa tiež, ako debugovať a testovať MCP servery, spravovať API a nasadzovať riešenia do cloudu pomocou Azure. Tieto praktické zdroje sú navrhnuté tak, aby urýchlili vaše učenie a pomohli vám s istotou vytvárať robustné, produkčne pripravené MCP aplikácie.
Táto lekcia sa zameriava na praktické aspekty implementácie MCP naprieč viacerými programovacími jazykmi. Preskúmame, ako používať MCP SDK v C#, Java so Spring, TypeScript, JavaScript a Python na vytváranie robustných aplikácií, debugovanie a testovanie MCP serverov a vytváranie opakovane použiteľných zdrojov, promptov a nástrojov.
Na konci tejto lekcie budete schopní:
- Implementovať MCP riešenia pomocou oficiálnych SDK v rôznych programovacích jazykoch
- Systematicky debugovať a testovať MCP servery
- Vytvárať a používať funkcie servera (Zdroje, Prompty a Nástroje)
- Navrhovať efektívne MCP pracovné postupy pre komplexné úlohy
- Optimalizovať implementácie MCP pre výkon a spoľahlivosť
Model Context Protocol ponúka oficiálne SDK pre viaceré jazyky:
- C# SDK
- Java so Spring SDK Poznámka: vyžaduje závislosť na Project Reactor. (Pozrite si diskusiu issue 246.)
- TypeScript SDK
- Python SDK
- Kotlin SDK
Táto sekcia poskytuje praktické príklady implementácie MCP naprieč viacerými programovacími jazykmi. Ukážkový kód nájdete v adresári samples organizovanom podľa jazyka.
Repozitár obsahuje ukážkové implementácie v nasledujúcich jazykoch:
Každá ukážka demonštruje kľúčové koncepty MCP a implementačné vzory pre konkrétny jazyk a ekosystém.
MCP servery môžu implementovať akúkoľvek kombináciu týchto funkcií:
Zdroje poskytujú kontext a dáta pre používateľa alebo AI model na použitie:
- Dokumentové repozitáre
- Znalostné databázy
- Štruktúrované dátové zdroje
- Súborové systémy
Prompty sú šablónové správy a pracovné postupy pre používateľov:
- Preddefinované konverzačné šablóny
- Riadené interakčné vzory
- Špecializované štruktúry dialógu
Nástroje sú funkcie, ktoré AI model vykonáva:
- Nástroje na spracovanie dát
- Integrácie externých API
- Výpočtové schopnosti
- Funkcionalita vyhľadávania
Oficiálny C# SDK repozitár obsahuje niekoľko ukážkových implementácií demonštrujúcich rôzne aspekty MCP:
- Základný MCP klient: Jednoduchý príklad, ako vytvoriť MCP klienta a volať nástroje
- Základný MCP server: Minimálna implementácia servera so základnou registráciou nástrojov
- Pokročilý MCP server: Plne vybavený server s registráciou nástrojov, autentifikáciou a spracovaním chýb
- Integrácia s ASP.NET: Príklady demonštrujúce integráciu s ASP.NET Core
- Vzory implementácie nástrojov: Rôzne vzory implementácie nástrojov s rôznou úrovňou zložitosti
C# SDK MCP je v náhľade a API sa môžu meniť. Tento blog budeme priebežne aktualizovať, ako sa SDK vyvíja.
- C# MCP Nuget ModelContextProtocol
- Vytvorenie vášho prvého MCP servera.
Pre kompletné ukážky implementácie v C# navštívte oficiálny repozitár ukážok C# SDK
Java so Spring SDK ponúka robustné možnosti implementácie MCP s funkciami na úrovni podnikového prostredia.
- Integrácia s Spring Framework
- Silná typová bezpečnosť
- Podpora reaktívneho programovania
- Komplexné spracovanie chýb
Pre kompletnú ukážku implementácie v Java so Spring si pozrite Java so Spring ukážku v adresári ukážok.
JavaScript SDK poskytuje ľahký a flexibilný prístup k implementácii MCP.
- Podpora Node.js a prehliadača
- API založené na Promise
- Jednoduchá integrácia s Express a ďalšími frameworkmi
- Podpora WebSocket pre streamovanie
Pre kompletnú ukážku implementácie v JavaScript si pozrite JavaScript ukážku v adresári ukážok.
Python SDK ponúka Pythonický prístup k implementácii MCP s výbornou integráciou ML frameworkov.
- Podpora Async/await s asyncio
- Integrácia s FastAPI
- Jednoduchá registrácia nástrojov
- Natívna integrácia s populárnymi ML knižnicami
Pre kompletnú ukážku implementácie v Python si pozrite Python ukážku v adresári ukážok.
Azure API Management je skvelým riešením na zabezpečenie MCP serverov. Myšlienka je umiestniť Azure API Management inštanciu pred váš MCP server a nechať ju spravovať funkcie, ktoré pravdepodobne budete chcieť, ako napríklad:
- obmedzovanie rýchlosti
- správa tokenov
- monitorovanie
- vyvažovanie záťaže
- bezpečnosť
Tu je Azure ukážka, ktorá presne toto robí, t.j. vytvorenie MCP servera a jeho zabezpečenie pomocou Azure API Management.
Pozrite si, ako prebieha autorizačný tok na obrázku nižšie:
Na predchádzajúcom obrázku sa deje nasledovné:
- Autentifikácia/autorizácia prebieha pomocou Microsoft Entra.
- Azure API Management funguje ako brána a používa politiky na smerovanie a správu prevádzky.
- Azure Monitor zaznamenáva všetky požiadavky na ďalšiu analýzu.
Pozrime sa na autorizačný tok podrobnejšie:
Viac informácií o špecifikácii autorizácie MCP
Pozrime sa, či môžeme nasadiť ukážku, ktorú sme spomenuli vyššie:
-
Naklonujte repozitár
git clone https://github.com/Azure-Samples/remote-mcp-apim-functions-python.git cd remote-mcp-apim-functions-python -
Zaregistrujte poskytovateľa zdrojov
Microsoft.App.- Ak používate Azure CLI, spustite
az provider register --namespace Microsoft.App --wait. - Ak používate Azure PowerShell, spustite
Register-AzResourceProvider -ProviderNamespace Microsoft.App. Potom po chvíli spustite(Get-AzResourceProvider -ProviderNamespace Microsoft.App).RegistrationState, aby ste skontrolovali, či je registrácia dokončená.
- Ak používate Azure CLI, spustite
-
Spustite tento azd príkaz na zriadenie služby správy API, funkčnej aplikácie (s kódom) a všetkých ďalších potrebných Azure zdrojov
azd up
Tento príkaz by mal nasadiť všetky cloudové zdroje na Azure.
-
V novom okne terminálu nainštalujte a spustite MCP Inspector
npx @modelcontextprotocol/inspector
Mali by ste vidieť rozhranie podobné:
-
CTRL kliknite na načítanie webovej aplikácie MCP Inspector z URL zobrazeného aplikáciou (napr. http://127.0.0.1:6274/#resources)
-
Nastavte typ transportu na
SSE -
Nastavte URL na váš bežiaci API Management SSE endpoint zobrazený po
azd upa Pripojiť:https://<apim-servicename-from-azd-output>.azure-api.net/mcp/sse
-
Zoznam nástrojov. Kliknite na nástroj a Spustiť nástroj.
Ak všetky kroky fungovali, mali by ste byť teraz pripojení k MCP serveru a mali by ste byť schopní zavolať nástroj.
Remote-mcp-functions: Táto sada repozitárov je rýchlym štartovacím šablónom na vytváranie a nasadzovanie vlastných vzdialených MCP (Model Context Protocol) serverov pomocou Azure Functions s Python, C# .NET alebo Node/TypeScript.
Ukážky poskytujú kompletné riešenie, ktoré umožňuje vývojárom:
- Vytvárať a spúšťať lokálne: Vyvíjať a debugovať MCP server na lokálnom počítači
- Nasadiť na Azure: Jednoducho nasadiť do cloudu pomocou jednoduchého príkazu azd up
- Pripojiť sa z klientov: Pripojiť sa k MCP serveru z rôznych klientov vrátane režimu agenta VS Code Copilot a nástroja MCP Inspector
- Bezpečnosť od základu: MCP server je zabezpečený pomocou kľúčov a HTTPS
- Možnosti autentifikácie: Podpora OAuth pomocou zabudovanej autentifikácie a/alebo správy API
- Izolácia siete: Umožňuje izoláciu siete pomocou Azure Virtual Networks (VNET)
- Serverless architektúra: Využíva Azure Functions na škálovateľné, udalosťami riadené vykonávanie
- Lokálny vývoj: Komplexná podpora lokálneho vývoja a debugovania
- Jednoduché nasadenie: Zjednodušený proces nasadenia na Azure
Repozitár obsahuje všetky potrebné konfiguračné súbory, zdrojový kód a definície infraštruktúry na rýchly štart s produkčne pripravenou implementáciou MCP servera.
-
Azure Remote MCP Functions Python - Ukážková implementácia MCP pomocou Azure Functions s Python
-
Azure Remote MCP Functions .NET - Ukážková implementácia MCP pomocou Azure Functions s C# .NET
-
Azure Remote MCP Functions Node/Typescript - Ukážková implementácia MCP pomocou Azure Functions s Node/TypeScript.
- MCP SDK poskytujú jazykovo špecifické nástroje na implementáciu robustných MCP riešení
- Proces debugovania a testovania je kritický pre spoľahlivé MCP aplikácie
- Opakovane použiteľné šablóny promptov umožňujú konzistentné AI interakcie
- Dobre navrhnuté pracovné postupy môžu orchestrovať komplexné úlohy pomocou viacerých nástrojov
- Implementácia MCP riešení vyžaduje zohľadnenie bezpečnosti, výkonu a spracovania chýb
Navrhnite praktický MCP pracovný postup, ktorý rieši reálny problém vo vašej oblasti:
- Identifikujte 3-4 nástroje, ktoré by boli užitočné na riešenie tohto problému
- Vytvorte diagram pracovného postupu, ktorý ukazuje, ako tieto nástroje interagujú
- Implementujte základnú verziu jedného z nástrojov pomocou vášho preferovaného jazyka
- Vytvorte šablónu promptu, ktorá by modelu pomohla efektívne používať váš nástroj
Ďalej: Pokročilé témy
Upozornenie:
Tento dokument bol preložený pomocou služby na automatický preklad Co-op Translator. Hoci sa snažíme o presnosť, upozorňujeme, že automatické preklady môžu obsahovať chyby alebo nepresnosti. Pôvodný dokument v jeho pôvodnom jazyku by mal byť považovaný za autoritatívny zdroj. Pre dôležité informácie odporúčame profesionálny ľudský preklad. Nezodpovedáme za žiadne nedorozumenia alebo nesprávne interpretácie vyplývajúce z použitia tohto prekladu.