Skip to content

Latest commit

 

History

History
260 lines (193 loc) · 19.9 KB

File metadata and controls

260 lines (193 loc) · 19.9 KB

MCP-for-beginners

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Azure AI Foundry Discord

Kövesd az alábbi lépéseket, hogy elkezdhess dolgozni ezekkel az erőforrásokkal:

  1. Forkold a tárolót: Kattints ide GitHub forks
  2. Klónozd a tárolót: git clone https://github.com/microsoft/mcp-for-beginners.git
  3. Csatlakozz az Azure AI Foundry Discord szerverhez, és ismerkedj meg szakértőkkel és fejlesztőtársakkal

🌐 Többnyelvű támogatás

GitHub Action segítségével támogatott (Automatikus és mindig naprakész)

Francia | Spanyol | Német | Orosz | Arab | Perzsa (Fárszi) | Urdu | Kínai (egyszerűsített) | Kínai (hagyományos, Makaó) | Kínai (hagyományos, Hongkong) | Kínai (hagyományos, Tajvan) | Japán | Koreai | Hindi | Bengáli | Marathi | Nepáli | Pandzsábi (Gurmukhi) | Portugál (Portugália) | Portugál (Brazília) | Olasz | Lengyel | Török | Görög | Thai | Svéd | Dán | Norvég | Finn | Holland | Héber | Vietnami | Indonéz | Maláj | Tagalog (Filippínó) | Szuahéli | Magyar | Cseh | Szlovák | Román | Bolgár | Szerb (cirill) | Horvát | Szlovén | Ukrán | Burmai (Myanmar)

🚀 Model Context Protocol (MCP) tananyag kezdőknek

Tanulj MCP-t gyakorlati kódpéldákon keresztül C#, Java, JavaScript, Python és TypeScript nyelveken

🧠 A Model Context Protocol tananyag áttekintése

A Model Context Protocol (MCP) egy élvonalbeli keretrendszer, amely az AI modellek és kliensalkalmazások közötti interakciók szabványosítására szolgál. Ez a nyílt forráskódú tananyag egy jól felépített tanulási útvonalat kínál, gyakorlati kódpéldákkal és valós használati esetekkel, népszerű programozási nyelveken, mint a C#, Java, JavaScript, TypeScript és Python.

Legyél akár AI fejlesztő, rendszertervező vagy szoftvermérnök, ez az útmutató átfogó forrásod az MCP alapjainak és megvalósítási stratégiáinak elsajátításához.

🔗 Hivatalos MCP erőforrások

Csatlakozz hozzánk az MCP Dev Days eseményen 2025. július 29-30-án

Készülj fel két nap mély technikai betekintésre, közösségi kapcsolatokra és gyakorlati tanulásra az MCP Dev Days-en, egy virtuális eseményen, amely a Model Context Protocol (MCP) – az AI modelleket és az azokat támogató eszközöket összekötő új szabvány – köré épül.

➡️ Regisztrálj az MCP Dev Days-re

Az MCP Dev Days eseményt az eseményoldalunkon keresztül nézheted élőben: https://aka.ms/mcpdevdays. Innen csatlakozhatsz a YouTube vagy Twitch élő közvetítéshez. Az összes tartalom rögzítésre kerül, és később elérhető lesz a Microsoft Developer YouTube csatornán. A demók forráskódja szintén elérhető lesz GitHubon.

Esemény részletei

  • Időpontok: július 29. (1. nap) és július 30. (2. nap)
  • Időpont: naponta 9:00 AM PST
  • Helyszín: Online – bárhonnan csatlakozhatsz!

1. nap: MCP termelékenység, fejlesztői eszközök és közösség

A fejlesztők támogatásáról szól, hogy MCP-t használjanak a munkafolyamatukban, és az MCP közösség ünnepléséről. Közösségi tagokkal és partnerekkel, mint az Arcade, Block, Okta és Neon együttműködve mutatjuk be, hogyan alakítják az MCP nyílt, bővíthető ökoszisztémáját a Microsofttal közösen. Valós demók VS Code, Visual Studio, GitHub Copilot és népszerű közösségi eszközök terén
Gyakorlati, kontextus-alapú fejlesztői munkafolyamatok
Közösség által vezetett szekciók és betekintések
Akár most kezded az MCP-t, akár már építesz vele, az 1. nap inspirációt és hasznos tanulságokat kínál.

2. nap: MCP szerverek magabiztos építése

Az MCP fejlesztőknek szól. Mélyrehatóan foglalkozunk a megvalósítási stratégiákkal és legjobb gyakorlatokkal MCP szerverek létrehozásához és az MCP integrálásához AI munkafolyamataidba.

Témák:

  • MCP szerverek építése és integrálása ügynök élményekbe
  • Prompt-alapú fejlesztés
  • Biztonsági legjobb gyakorlatok
  • Építőelemek használata, mint Functions, ACA és API Management
  • Regisztrációs összehangolás és eszközök (1P + 3P)

Ha fejlesztő, eszközfejlesztő vagy AI termékstratégia szakértő vagy, ez a nap tele lesz azokkal az ismeretekkel, amelyekkel skálázható, biztonságos és jövőálló MCP megoldásokat építhetsz.

🧭 MCP tananyag áttekintése

📚 Teljes tananyag felépítés

Modul Téma Leírás Link
1-3. modul: Alapok
00 Bevezetés az MCP-be A Model Context Protocol áttekintése és jelentősége az AI folyamatokban Tovább
01 Alapfogalmak magyarázata Az MCP alapfogalmainak mélyreható bemutatása Tovább
02 Biztonság az MCP-ben Biztonsági fenyegetések és legjobb gyakorlatok Tovább
03 MCP használatának megkezdése Környezet beállítása, alap szerverek/kliensek, integráció Tovább
3. modul: Az első szerver és kliens építése
3.1 Első szerver Készítsd el az első MCP szerveredet Útmutató
3.2 Első kliens Fejlessz egy alap MCP klienst Útmutató
3.3 Kliens LLM-mel Nagy nyelvi modellek integrálása Útmutató
3.4 VS Code integráció MCP szerverek használata VS Code-ban Útmutató
3.5 SSE szerver Szerverek létrehozása Server-Sent Events használatával Útmutató
3.6 HTTP streaming HTTP streaming megvalósítása MCP-ben Útmutató
3.7 AI eszköztár AI eszköztár használata MCP-vel Útmutató
3.8 Tesztelés MCP szerver implementáció tesztelése Útmutató
3.9 Telepítés MCP szerverek éles környezetbe telepítése Útmutató
4-5. modul: Gyakorlati és haladó témák
04 Gyakorlati megvalósítás SDK-k, hibakeresés, tesztelés, újrahasználható prompt sablonok Tovább
05 Haladó MCP témák Többmodalitású AI, skálázás, vállalati használat Tovább
5.1 Azure integráció MCP integráció Azure-ral Útmutató
5.2 Többmodalitás Több modalitás kezelése Útmutató
5.3 OAuth2 demo OAuth2 hitelesítés megvalósítása Útmutató
5.4 Root kontextusok Root kontextusok megértése és implementálása Útmutató
5.5 Routing MCP routing stratégiák Útmutató
5.6 Mintavételezés Mintavételezési technikák MCP-ben Útmutató
5.7 Skálázás MCP megvalósítások skálázása Útmutató
5.8 Biztonság Haladó biztonsági szempontok Útmutató
5.9 Web keresés Webes keresési funkciók megvalósítása Útmutató
5.10 Valós idejű streaming Valós idejű streaming funkció építése Útmutató
5.11 Valós idejű keresés Valós idejű keresés megvalósítása Útmutató
5.12 Entra ID hitelesítés Hitelesítés Microsoft Entra ID-vel Útmutató
5.13 Foundry integráció Integráció az Azure AI Foundry-val Útmutató
5.14 Kontextus mérnökség Hatékony kontextus-mérnökségi technikák Útmutató
6-10. modul: Közösség és legjobb gyakorlatok
06 Közösségi hozzájárulások Hogyan járulhatsz hozzá az MCP ökoszisztémához Útmutató
07 Korai alkalmazás tapasztalatai Valós megvalósítási történetek Útmutató
08 MCP legjobb gyakorlatok Teljesítmény, hibabiztosság, ellenálló képesség Útmutató
09 MCP esettanulmányok Gyakorlati megvalósítási példák Útmutató
10 Gyakorlati workshop MCP szerver építése AI eszközkészlettel Labor

💻 Minta kód projektek

Alap MCP kalkulátor minták

Nyelv Leírás Link
C# MCP szerver példa Kód megtekintése
Java MCP kalkulátor Kód megtekintése
JavaScript MCP demó Kód megtekintése
Python MCP szerver Kód megtekintése
TypeScript MCP példa Kód megtekintése

Haladó MCP megvalósítások

Nyelv Leírás Link
C# Haladó minta Kód megtekintése
Java Konténer alkalmazás példa Kód megtekintése
JavaScript Haladó minta Kód megtekintése
Python Összetett megvalósítás Kód megtekintése
TypeScript Konténer minta Kód megtekintése

🎯 Az MCP tanulás előfeltételei

Ahhoz, hogy a legtöbbet hozd ki ebből a tananyagból, érdemes rendelkezned:

  • Alap programozási ismeretekkel legalább az alábbi nyelvek egyikében: C#, Java, JavaScript, Python vagy TypeScript

  • A kliens-szerver modell és az API-k megértésével

  • REST és HTTP fogalmak ismeretével

  • (Opcionálisan) AI/ML alapokkal

  • Csatlakozás a közösségi beszélgetéseinkhez támogatásért

📚 Tanulási útmutató és források

Ez a tároló több forrást is tartalmaz, hogy hatékonyan tudj eligazodni és tanulni:

Tanulási útmutató

Egy átfogó Tanulási útmutató áll rendelkezésre, amely segít eligazodni ebben a tárolóban. Az útmutató tartalmazza:

  • Egy vizuális tantervtérképet az összes témakörrel
  • Részletes bontást a tároló egyes részeiről
  • Útmutatót a minta projektek használatához
  • Ajánlott tanulási útvonalakat különböző szintű tanulók számára
  • Kiegészítő forrásokat a tanulási folyamat támogatására

Változásnapló

Részletes Változásnaplót vezetünk, amely nyomon követi a tananyag anyagok jelentős frissítéseit, beleértve:

  • Új tartalmak hozzáadását
  • Strukturális változtatásokat
  • Funkciófejlesztéseket
  • Dokumentációs frissítéseket

🛠️ Hogyan használd hatékonyan ezt a tananyagot

Minden leckében megtalálod:

  1. Az MCP fogalmak világos magyarázatát
  2. Élő kód példákat több nyelven
  3. Gyakorlatokat valós MCP alkalmazások építéséhez
  4. Kiegészítő forrásokat haladó tanulók számára

🌟 Közösségi köszönetnyilvánítás

Köszönet Microsoft Valued Professional Shivam Goyal számára a fontos kódmintákért.

📜 Licenc információk

Ez a tartalom az MIT Licenc alatt áll. A feltételekért lásd a LICENSE fájlt.

🤝 Hozzájárulási irányelvek

Ez a projekt szívesen fogad hozzájárulásokat és javaslatokat. A legtöbb hozzájáruláshoz el kell fogadnod egy Contributor License Agreement (CLA) megállapodást, amelyben kijelented, hogy jogodban áll, és ténylegesen megadod számunkra a hozzájárulásod használatának jogát. Részletekért látogass el ide: https://cla.opensource.microsoft.com.

Amikor pull request-et küldesz, egy CLA bot automatikusan megállapítja, hogy szükséges-e CLA-t benyújtanod, és ennek megfelelően jelöli a PR-t (pl. státusz ellenőrzés, komment). Egyszerűen kövesd a bot utasításait. Ezt csak egyszer kell megtenned az összes CLA-t használó tárolóban.

Ez a projekt elfogadta a Microsoft Open Source Code of Conduct irányelveit. További információkért lásd a Code of Conduct FAQ oldalt, vagy keresd az opencode@microsoft.com címet további kérdésekkel vagy észrevételekkel.

📂 A tároló felépítése

A tároló a következőképpen van felépítve:

  • Core Curriculum (00-10): A fő tartalom tíz egymásra épülő modulban
  • images/: Diagramok és illusztrációk a tananyagban
  • translations/: Többnyelvű támogatás automatikus fordításokkal
  • translated_images/: Lokalizált diagramok és illusztrációk
  • study_guide.md: Átfogó útmutató a tároló használatához
  • changelog.md: A tananyag jelentős változásainak nyilvántartása
  • mcp.json: MCP specifikáció konfigurációs fájlja
  • CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Projekt irányelvek dokumentumai

🎒 Egyéb tanfolyamok

Csapatunk más tanfolyamokat is készít! Nézd meg:

™️ Védjegy értesítés

Ez a projekt tartalmazhat védjegyeket vagy logókat projektekhez, termékekhez vagy szolgáltatásokhoz. A Microsoft védjegyek vagy logók jogosult használata a Microsoft védjegy- és márka irányelveinek betartásával történhet. A Microsoft védjegyek vagy logók módosított verziókban történő használata nem okozhat félreértést, és nem sugallhat Microsoft támogatást. Harmadik fél védjegyeinek vagy logóinak használata az adott harmadik fél szabályzatai szerint történik.

Jogi nyilatkozat:
Ez a dokumentum az AI fordító szolgáltatás, a Co-op Translator segítségével készült. Bár a pontosságra törekszünk, kérjük, vegye figyelembe, hogy az automatikus fordítások hibákat vagy pontatlanságokat tartalmazhatnak. Az eredeti dokumentum az anyanyelvén tekintendő hiteles forrásnak. Fontos információk esetén szakmai, emberi fordítást javaslunk. Nem vállalunk felelősséget a fordítás használatából eredő félreértésekért vagy téves értelmezésekért.