Skip to content

Latest commit

 

History

History
261 lines (194 loc) · 19.9 KB

File metadata and controls

261 lines (194 loc) · 19.9 KB

MCP-aloittelijoille

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Azure AI Foundry Discord

Seuraa näitä vaiheita aloittaaksesi näiden resurssien käytön:

  1. Haarauta repositorio: Klikkaa GitHub forks
  2. Kloonaa repositorio: git clone https://github.com/microsoft/mcp-for-beginners.git
  3. Liity Azure AI Foundry Discordiin ja tapaa asiantuntijoita sekä muita kehittäjiä

🌐 Monikielinen tuki

Tuettu GitHub Actionin kautta (automaattinen ja aina ajan tasalla)

Arabic | Bengali | Bulgarian | Burmese (Myanmar) | Chinese (Simplified) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Macau) | Chinese (Traditional, Taiwan) | Croatian | Czech | Danish | Dutch | Finnish | French | German | Greek | Hebrew | Hindi | Hungarian | Indonesian | Italian | Japanese | Korean | Malay | Marathi | Nepali | Norwegian | Persian (Farsi) | Polish | Portuguese (Brazil) | Portuguese (Portugal) | Punjabi (Gurmukhi) | Romanian | Russian | Serbian (Cyrillic) | Slovak | Slovenian | Spanish | Swahili | Swedish | Tagalog (Filipino) | Thai | Turkish | Ukrainian | Urdu | Vietnamese

🚀 Model Context Protocol (MCP) -opetusohjelma aloittelijoille

Opi MCP käytännön koodiesimerkeillä C#:ssa, Javassa, JavaScriptissä, Rustissa, Pythonissa ja TypeScriptissä

🧠 Model Context Protocol -opetusohjelman yleiskatsaus

Model Context Protocol (MCP) on huippuluokan kehys, joka on suunniteltu standardoimaan vuorovaikutukset tekoälymallien ja asiakassovellusten välillä. Tämä avoimen lähdekoodin opetusohjelma tarjoaa jäsennellyn oppimispolun, joka sisältää käytännön koodiesimerkkejä ja todellisia käyttötapauksia suosituilla ohjelmointikielillä, kuten C#, Java, JavaScript, TypeScript ja Python.

Olitpa tekoälykehittäjä, järjestelmäarkkitehti tai ohjelmistosuunnittelija, tämä opas on kattava resurssi MCP:n perusteiden ja toteutusstrategioiden hallintaan.

🔗 Viralliset MCP-resurssit

🧭 MCP-opetusohjelman yleiskatsaus

📚 Koko opetusohjelman rakenne

Moduuli Aihe Kuvaus Linkki
Moduuli 1-3: Perusteet
00 Johdatus MCP:hen Yleiskatsaus Model Context Protocoliin ja sen merkitykseen tekoälyputkistoissa Lue lisää
01 Keskeiset käsitteet Syvällinen tutkimus MCP:n keskeisistä käsitteistä Lue lisää
02 Turvallisuus MCP:ssä Turvauhat ja parhaat käytännöt Lue lisää
03 MCP:n käyttöönotto Ympäristön asennus, peruspalvelimet/asiakkaat, integrointi Lue lisää
Moduuli 3: Ensimmäisen palvelimen ja asiakkaan rakentaminen
3.1 Ensimmäinen palvelin Luo ensimmäinen MCP-palvelimesi Opas
3.2 Ensimmäinen asiakas Kehitä perus MCP-asiakas Opas
3.3 Asiakas LLM:llä Integroi suuret kielimallit Opas
3.4 VS Code -integraatio Käytä MCP-palvelimia VS Codessa Opas
3.5 stdio-palvelin Luo palvelimia stdio-kuljetuksella Opas
3.6 HTTP-suoratoisto Toteuta HTTP-suoratoisto MCP:ssä Opas
3.7 AI Toolkit Käytä AI Toolkitia MCP:n kanssa Opas
3.8 Testaus Testaa MCP-palvelimen toteutusta Opas
3.9 Käyttöönotto Ota MCP-palvelimet käyttöön tuotannossa Opas
Moduuli 4-5: Käytännön ja edistyneet aiheet
04 Käytännön toteutus SDK:t, virheenkorjaus, testaus, uudelleenkäytettävät kehotepohjat Lue lisää
05 Edistyneet aiheet MCP:ssä Monimodaalinen tekoäly, skaalaus, yrityskäyttö Lue lisää
5.1 Azure-integraatio MCP-integraatio Azureen Opas
5.2 Monimodaalisuus Työskentely useiden modaliteettien kanssa Opas
5.3 OAuth2-demo Toteuta OAuth2-autentikointi Opas
5.4 Juurikontekstit Ymmärrä ja toteuta juurikontekstit Opas
5.5 Reititys MCP-reititysstrategiat Opas
5.6 Näytteenotto Näytteenottotekniikat MCP:ssä Opas
5.7 Skaalaus Skaalaa MCP-toteutuksia Opas
5.8 Turvallisuus Edistyneet turvallisuusharkinnat Opas
5.9 Verkkohaku Toteuta verkkohakutoimintoja Opas
5.10 Reaaliaikainen suoratoisto Rakenna reaaliaikainen suoratoistotoiminto Opas
5.11 Reaaliaikainen haku Toteuta reaaliaikainen haku Opas
5.12 Entra ID -autentikointi Autentikointi Microsoft Entra ID:llä Opas
5.13 Foundry-integraatio Integrointi Azure AI Foundryyn Opas
5.14 Kontekstisuunnittelu Tekniikat tehokkaaseen kontekstisuunnitteluun Opas
Moduuli 6-10: Yhteisö ja parhaat käytännöt
06 Yhteisön panokset Kuinka osallistua MCP-ekosysteemiin Opas
07 Oivalluksia varhaisesta käyttöönotosta Todelliset toteutustarinat Opas
08 MCP:n parhaat käytännöt Suorituskyky, vikasietoisuus, kestävyys Opas
09 MCP-tapaustutkimukset Käytännön toteutusesimerkit Opas
10 Käytännön työpaja MCP-palvelimen rakentaminen AI Toolkitilla Lab

💻 Esimerkkiprojektit

Perus MCP-laskin

Kieli Kuvaus Linkki
C# MCP-palvelimen esimerkki Katso koodi
Java MCP-laskin Katso koodi
JavaScript MCP-demo Katso koodi
Python MCP-palvelin Katso koodi
TypeScript MCP-esimerkki Katso koodi
Rust MCP-esimerkki Katso koodi

Edistyneet MCP-toteutukset

Kieli Kuvaus Linkki
C# Edistynyt esimerkki View Code
Java with Spring Sovelluskonttiesimerkki View Code
JavaScript Edistynyt esimerkki View Code
Python Monimutkainen toteutus View Code
TypeScript Konttiesimerkki View Code

🎯 MCP:n oppimisen edellytykset

Jotta saat parhaan hyödyn tästä oppimateriaalista, sinulla tulisi olla:

  • Perustiedot ohjelmoinnista vähintään yhdessä seuraavista kielistä: C#, Java, JavaScript, Python tai TypeScript

  • Ymmärrys asiakas-palvelin-mallista ja API:ista

  • REST- ja HTTP-konseptien tuntemus

  • (Valinnainen) Taustatietoa AI/ML-konsepteista

  • Osallistuminen yhteisökeskusteluihin tuen saamiseksi

📚 Opas ja resurssit

Tämä arkisto sisältää useita resursseja, jotka auttavat sinua navigoimaan ja oppimaan tehokkaasti:

Opas

Kattava Opas on saatavilla, jotta voit navigoida tässä arkistossa tehokkaasti. Oppaassa on:

  • Visuaalinen opintokartta, joka näyttää kaikki käsitellyt aiheet
  • Yksityiskohtainen jaottelu arkiston osioista
  • Ohjeet näyteprojektien käyttöön
  • Suositellut oppimispolut eri taitotasoille
  • Lisäresursseja oppimisen täydentämiseksi

Muutosloki

Pidämme yksityiskohtaista Muutoslokia, joka seuraa kaikkia merkittäviä päivityksiä oppimateriaalissa, mukaan lukien:

  • Uudet sisältölisäykset
  • Rakenteelliset muutokset
  • Ominaisuuksien parannukset
  • Dokumentaation päivitykset

🛠️ Kuinka käyttää tätä oppimateriaalia tehokkaasti

Jokainen oppitunti sisältää:

  1. Selkeät selitykset MCP-konsepteista
  2. Live-koodiesimerkkejä useilla kielillä
  3. Harjoituksia MCP-sovellusten rakentamiseen
  4. Lisäresursseja edistyneille oppijoille

Tapahtumat

Valmistaudu kahden päivän syvälliseen tekniseen oppimiseen, yhteisön verkostoitumiseen ja käytännön oppimiseen MCP Dev Days -tapahtumassa, joka on virtuaalinen tapahtuma keskittyen Model Context Protocoliin (MCP) — nousevaan standardiin, joka yhdistää AI-mallit ja niiden käyttämät työkalut. Voit katsoa MCP Dev Days -tapahtuman rekisteröitymällä tapahtumasivullamme: https://aka.ms/mcpdevdays.

Keskittyy kehittäjien voimaannuttamiseen MCP:n käytössä heidän kehitystyönkulussaan ja MCP-yhteisön juhlistamiseen. Mukana ovat yhteisön jäsenet ja kumppanit, kuten Arcade, Block, Okta ja Neon, jotka näyttävät, kuinka he tekevät yhteistyötä Microsoftin kanssa avoimen ja laajennettavan MCP-ekosysteemin luomiseksi.
Reaaliaikaisia demoja VS Code, Visual Studio, GitHub Copilot ja suosittujen yhteisötyökalujen parissa
Käytännönläheisiä, kontekstiin perustuvia kehitystyönkulkuja
Yhteisön vetämiä sessioita ja näkemyksiä
Olitpa vasta aloittamassa MCP:n kanssa tai jo rakentamassa sen avulla, päivä 1 tarjoaa inspiraatiota ja konkreettisia vinkkejä.

On tarkoitettu MCP-rakentajille. Sukellamme syvälle toteutusstrategioihin ja parhaisiin käytäntöihin MCP-palvelimien luomisessa ja MCP:n integroinnissa AI-työnkulkuihin.

Aiheet sisältävät:

  • MCP-palvelimien rakentaminen ja niiden integrointi agenttikokemuksiin
  • Kehitys ohjattuna kehotteilla
  • Turvallisuuden parhaat käytännöt
  • Rakennuspalikoiden, kuten Functions, ACA ja API Management, käyttö
  • Rekisterin yhdenmukaistaminen ja työkalut (1P + 3P)

Jos olet kehittäjä, työkalujen rakentaja tai AI-tuotestrategi, tämä päivä tarjoaa tarvitsemasi näkemykset skaalautuvien, turvallisten ja tulevaisuuteen valmiiden MCP-ratkaisujen rakentamiseen.

MCP Boot Camp elokuu 2025

Opettele intensiivisissä videosessioissa, kuinka luoda MCP-palvelimia, integroida VS Codeen ja ottaa käyttöön ammatillisesti Azureen MCP for Beginners -oppimateriaalin sisällön pohjalta. Saat käytännön taitoja teknologiasta, jota suuret yritykset jo käyttävät.

🌟 Kiitokset yhteisölle

Kiitokset Microsoft Valued Professionalille Shivam Goyal tärkeiden koodiesimerkkien tuottamisesta.

📜 Lisenssitiedot

Tämä sisältö on lisensoitu MIT-lisenssillä. Ehdot ja edellytykset löytyvät LICENSE.

🤝 Ohjeet osallistumiseen

Tämä projekti toivottaa tervetulleeksi osallistumisen ja ehdotukset. Useimmat osallistumiset edellyttävät, että hyväksyt Contributor License Agreementin (CLA), jossa vakuutat, että sinulla on oikeus ja todellisuudessa annat meille oikeudet käyttää panostasi. Lisätietoja:
https://cla.opensource.microsoft.com.

Kun lähetät pull requestin, CLA-botti määrittää automaattisesti, tarvitsetko CLA:n ja merkitsee PR:n asianmukaisesti (esim. tilatarkistus, kommentti). Seuraa yksinkertaisesti botin antamia ohjeita. Sinun tarvitsee tehdä tämä vain kerran kaikissa CLA:ta käyttävissä arkistoissa.

Tämä projekti on omaksunut Microsoft Open Source Code of Conductin.
Lisätietoja löytyy Code of Conduct FAQ tai ota yhteyttä opencode@microsoft.com lisäkysymyksissä tai kommenteissa.

📂 Arkiston rakenne

Arkisto on järjestetty seuraavasti:

  • Core Curriculum (00-10): Pääsisältö, joka on järjestetty kymmeneen peräkkäiseen moduuliin
  • images/: Kaaviot ja kuvitukset, joita käytetään oppimateriaalissa
  • translations/: Monikielinen tuki automaattisilla käännöksillä
  • translated_images/: Lokalisoidut versiot kaavioista ja kuvituksista
  • study_guide.md: Kattava opas arkiston navigointiin
  • changelog.md: Merkittävien muutosten kirjaus oppimateriaaleissa
  • mcp.json: MCP-määrittelyn konfiguraatiotiedosto
  • CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Projektin hallintadokumentit

🎒 Muut kurssit

Tiimimme tuottaa muita kursseja! Tutustu:

™️ Tavaramerkkihuomautus

Tämä projekti saattaa sisältää tavaramerkkejä tai logoja projekteille, tuotteille tai palveluille. Microsoftin tavaramerkkien tai logojen valtuutettu käyttö on Microsoftin tavaramerkki- ja brändiohjeiden mukaista:
Microsoft's Trademark & Brand Guidelines.
Microsoftin tavaramerkkien tai logojen käyttö muokatuissa projektiversioissa ei saa aiheuttaa sekaannusta tai antaa ymmärtää Microsoftin sponsorointia.
Kolmannen osapuolen tavaramerkkien tai logojen käyttö on kyseisten osapuolten käytäntöjen alaista.


Vastuuvapauslauseke:
Tämä asiakirja on käännetty käyttämällä tekoälypohjaista käännöspalvelua Co-op Translator. Vaikka pyrimme tarkkuuteen, huomioithan, että automaattiset käännökset voivat sisältää virheitä tai epätarkkuuksia. Alkuperäistä asiakirjaa sen alkuperäisellä kielellä tulisi pitää ensisijaisena lähteenä. Kriittisen tiedon osalta suositellaan ammattimaista ihmiskäännöstä. Emme ole vastuussa väärinkäsityksistä tai virhetulkinnoista, jotka johtuvat tämän käännöksen käytöstä.