Skip to content

Latest commit

 

History

History
258 lines (190 loc) · 19.3 KB

File metadata and controls

258 lines (190 loc) · 19.3 KB

MCP-for-beginners

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Azure AI Foundry Discord

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

  1. Forkkaa 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)

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

🚀 Model Context Protocol (MCP) -opintokokonaisuus aloittelijoille

Opiskele MCP:tä käytännön koodiesimerkkien avulla C#:ssa, Javassa, JavaScriptissä, Pythonissa ja TypeScriptissä

🧠 Yleiskatsaus Model Context Protocol -opintokokonaisuuteen

Model Context Protocol (MCP) on huipputason kehys, joka on suunniteltu vakioimaan vuorovaikutus tekoälymallien ja asiakasohjelmien välillä. Tämä avoimen lähdekoodin opintokokonaisuus 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.

Oletpa sitten tekoälykehittäjä, järjestelmäarkkitehti tai ohjelmistoinsinööri, tämä opas on kattava resurssi MCP:n perusteiden ja toteutusstrategioiden hallintaan.

🔗 Viralliset MCP-resurssit

Liity mukaan MCP Dev Days -tapahtumaan 29.-30. heinäkuuta 2025

Valmistaudu kahteen päivään syvällistä teknistä tietoa, yhteisön verkostoitumista ja käytännön oppimista MCP Dev Days -virtuaalitapahtumassa, joka on omistettu Model Context Protocolille (MCP) — nousevalle standardille, joka yhdistää tekoälymallit ja niiden käyttämät työkalut.

➡️ Rekisteröidy MCP Dev Days -tapahtumaan

Voit katsoa MCP Dev Days -tapahtuman rekisteröitymällä tapahtumasivullamme: https://aka.ms/mcpdevdays. Sieltä pääset liittymään live-lähetykseen YouTubessa tai Twitchissä. Kaikki sisältö tallennetaan ja on katsottavissa myöhemmin Microsoft Developerin YouTube-kanavalla. Demoihin liittyvä lähdekoodi on myös saatavilla GitHubissa.

Tapahtuman tiedot

  • Päivät: 29. heinäkuuta (päivä 1) & 30. heinäkuuta (päivä 2)
  • Aika: klo 9:00 PST molempina päivinä
  • Missä: Verkossa – osallistu mistä tahansa!

Päivä 1: MCP-tuottavuus, kehitystyökalut ja yhteisö

Keskittyy kehittäjien voimaannuttamiseen MCP:n käytössä kehitystyössä ja upean MCP-yhteisön juhlistamiseen. Mukana ovat yhteisön jäsenet ja kumppanit kuten Arcade, Block, Okta ja Neon, jotka kertovat yhteistyöstään Microsoftin kanssa avoimen ja laajennettavan MCP-ekosysteemin rakentamiseksi. Todellisia demoja VS Codesta, Visual Studiosta, GitHub Copilotista ja suosituista yhteisötyökaluista
Käytännönläheisiä, kontekstipohjaisia kehitystyönkulkuja
Yhteisön vetämiä sessioita ja näkemyksiä
Olitpa vasta aloittamassa MCP:n kanssa tai jo rakentamassa sillä, päivä 1 tarjoaa inspiraatiota ja konkreettisia vinkkejä.

Päivä 2: Rakenna MCP-palvelimia luottavaisin mielin

Suunnattu MCP:n rakentajille. Syvennymme toteutusstrategioihin ja parhaisiin käytäntöihin MCP-palvelimien luomisessa ja MCP:n integroinnissa tekoälytyönkulkuihin.

Aiheet sisältävät:

  • MCP-palvelimien rakentaminen ja integrointi agenttikokemuksiin
  • Kehitys kehotteiden avulla
  • 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 tekoälytuotteen strategisti, tämä päivä on täynnä tietoa, jota tarvitset skaalautuvien, turvallisten ja tulevaisuuden vaatimukset täyttävien MCP-ratkaisujen rakentamiseen.

🧭 MCP-opintokokonaisuuden yleiskatsaus

📚 Koko opintokokonaisuuden rakenne

Moduuli Aihe Kuvaus Linkki
Moduulit 1-3: Perusteet
00 Johdanto MCP:hen Yleiskatsaus Model Context Protocoliin ja sen merkitykseen tekoälyputkissa Lue lisää
01 Keskeiset käsitteet selitettynä Syvällinen katsaus MCP:n keskeisiin käsitteisiin 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 SSE-palvelin Luo palvelimia Server-Sent Events -tekniikalla 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 toteutus Opas
3.9 Julkaisu Ota MCP-palvelimet tuotantokäyttöön Opas
Moduulit 4-5: Käytännön ja edistynyt taso
04 Käytännön toteutus SDK:t, virheenkorjaus, testaus, uudelleenkäytettävät kehotemallit Lue lisää
05 Edistyneet aiheet MCP:ssä Monimodaalinen tekoäly, skaalaus, yrityskäyttö Lue lisää
5.1 Azure-integraatio MCP:n integrointi Azureen Opas
5.2 Monimodaalisuus Työskentely useiden modaliteettien kanssa Opas
5.3 OAuth2-demo OAuth2-todennuksen toteutus Opas
5.4 Juurikontekstit Ymmärrä ja toteuta juurikontekstit Opas
5.5 Reititys MCP:n reititysstrategiat Opas
5.6 Otanta Otantatekniikat MCP:ssä Opas
5.7 Skaalaus Skaalaa MCP-toteutuksia Opas
5.8 Turvallisuus Edistyneet turvallisuusnäkökohdat Opas
5.9 Verkkohaku Toteuta verkkohakutoiminnot Opas
5.10 Reaaliaikainen suoratoisto Rakenna reaaliaikainen suoratoistotoiminnallisuus Opas
5.11 Reaaliaikainen haku Toteuta reaaliaikainen haku Opas
5.12 Entra ID -todennus Todennus Microsoft Entra ID:llä Opas
5.13 Foundry-integraatio Integrointi Azure AI Foundryn kanssa Opas
5.14 Kontekstisuunnittelu Tekniikoita tehokkaaseen kontekstisuunnitteluun Opas
Moduulit 6-10: Yhteisö & Parhaat käytännöt
06 Yhteisön panokset Kuinka osallistua MCP-ekosysteemiin Opas
07 Kokemuksia varhaisesta käyttöönotosta Käytännön toteutustarinoita Opas
08 MCP:n parhaat käytännöt Suorituskyky, vikasietoisuus, kestävyys Opas
09 MCP-tapaukset Käytännön toteutusesimerkkejä Opas
10 Käytännön työpaja MCP-palvelimen rakentaminen AI-työkalupakilla Lab

💻 Esimerkkikoodiprojektit

Perustason MCP-laskin

Kieli Kuvaus Linkki
C# MCP-palvelimen esimerkki Näytä koodi
Java MCP-laskin Näytä koodi
JavaScript MCP-demo Näytä koodi
Python MCP-palvelin Näytä koodi
TypeScript MCP-esimerkki Näytä koodi

Edistyneet MCP-toteutukset

Kieli Kuvaus Linkki
C# Edistynyt esimerkki Näytä koodi
Java Container-sovellus Näytä koodi
JavaScript Edistynyt esimerkki Näytä koodi
Python Monimutkainen toteutus Näytä koodi
TypeScript Container-esimerkki Näytä koodi

🎯 MCP:n oppimisen edellytykset

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

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

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

  • Tuntemus REST- ja HTTP-käsitteistä

  • (Valinnainen) Tausta tekoäly- ja koneoppimiskäsitteissä

  • Osallistuminen yhteisömme keskusteluihin tukena

📚 Opas & resurssit

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

Opas

Laaja Opas on saatavilla auttamaan sinua käyttämään tätä repositoriota tehokkaasti. Opas sisältää:

  • Visuaalisen opetussuunnitelmakartan kaikista käsitellyistä aiheista
  • Yksityiskohtaisen jaon repositorion osioista
  • Ohjeita esimerkkiprojektien käyttöön
  • Suositellut oppimispolut eri taitotasoille
  • Lisäresursseja oppimismatkan tueksi

Muutokset

Pidämme yllä yksityiskohtaista Muutokset -tiedostoa, joka seuraa kaikkia merkittäviä päivityksiä opetussuunnitelman materiaaleihin, mukaan lukien:

  • Uudet sisällöt
  • Rakenteelliset muutokset
  • Ominaisuuksien parannukset
  • Dokumentaation päivitykset

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

Jokainen tämän oppaan oppitunti sisältää:

  1. Selkeät selitykset MCP:n käsitteistä
  2. Live-koodiesimerkkejä useilla kielillä
  3. Harjoituksia oikeiden MCP-sovellusten rakentamiseen
  4. Lisäresursseja edistyneille oppijoille

🌟 Yhteisön kiitokset

Kiitos Microsoft Valued Professional Shivam Goyal tärkeistä koodiesimerkeistä.

📜 Lisenssitiedot

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

🤝 Osallistumisohjeet

Tämä projekti toivottaa tervetulleiksi panokset ja ehdotukset. Useimmat panokset edellyttävät, että hyväksyt Contributor License Agreementin (CLA), jossa vahvistat, että sinulla on oikeus ja myönnät meille oikeudet käyttää panostasi. Lisätietoja löytyy osoitteesta https://cla.opensource.microsoft.com.

Kun lähetät pull requestin, CLA-botti automaattisesti tarkistaa, tarvitsetko CLA:n ja merkitsee PR:n asianmukaisesti (esim. tilatarkistus, kommentti). Noudata botin ohjeita. Tämä riittää tekemään vain kerran kaikissa CLA:ta käyttävissä repositorioissa.

Tämä projekti on ottanut käyttöön Microsoft Open Source Code of Conductin. Lisätietoja löytyy Code of Conduct FAQ -sivulta tai ota yhteyttä osoitteeseen opencode@microsoft.com lisäkysymyksissä tai palautteessa.

📂 Repositorion rakenne

Repositorio on järjestetty seuraavasti:

  • Core Curriculum (00-10): Pääsisältö kymmenessä peräkkäisessä moduulissa
  • images/: Kaaviot ja kuvitukset opetussuunnitelman eri osissa
  • translations/: Monikielinen tuki automaattisilla käännöksillä
  • translated_images/: Paikallistetut versiot kaavioista ja kuvituksista
  • study_guide.md: Laaja opas repositorion käyttöön
  • changelog.md: Merkittävien muutosten kirjaus opetussuunnitelman materiaaleissa
  • mcp.json: MCP-määrittelyjen konfiguraatiotiedosto
  • CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Projektin hallintadokumentit

🎒 Muut kurssit

Tiimimme tuottaa myös muita kursseja! Tutustu:

™️ Tavaramerkki-ilmoitus

Tämä projekti saattaa sisältää tavaramerkkejä tai logoja projekteista, tuotteista tai palveluista. Microsoftin tavaramerkkien tai logojen luvallinen käyttö on ehdollista ja sen tulee noudattaa Microsoftin tavaramerkki- ja brändiohjeita. Microsoftin tavaramerkkien tai logojen käyttö muokatuissa versioissa ei saa aiheuttaa sekaannusta tai antaa vaikutelmaa Microsoftin sponsoroimasta projektista. Kolmansien osapuolten tavaramerkkien tai logojen käyttö on näiden osapuolten sää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ä automaattikäännöksissä saattaa esiintyä virheitä tai epätarkkuuksia. Alkuperäistä asiakirjaa sen alkuperäiskielellä tulee pitää virallisena lähteenä. Tärkeissä asioissa suositellaan ammattimaista ihmiskäännöstä. Emme ole vastuussa tämän käännöksen käytöstä aiheutuvista väärinymmärryksistä tai tulkinnoista.