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 päästäksesi alkuun näiden resurssien käytössä:

  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)

Arabia | Bengali | Bulgaria | Burma (Myanmar) | Kiina (yksinkertaistettu) | Kiina (perinteinen, Hongkong) | Kiina (perinteinen, Macao) | Kiina (perinteinen, Taiwan) | Kroatia | Tšekki | Tanska | Hollanti | Suomi | Ranska | Saksa | Kreikka | Heprea | Hindi | Unkari | Indonesia | Italia | Japani | Korea | Malaiji | Marathi | Nepali | Norja | Persia (Farsi) | Puola | Portugali (Brasilia) | Portugali (Portugali) | Punjabi (Gurmukhi) | Romania | Venäjä | Serbia (kyrillinen) | Slovakki | Sloveeni | Espanja | Swahili | Ruotsi | Tagalog (Filipino) | Thai | Turkki | Ukraina | Urdu | Vietnam

🚀 Model Context Protocol (MCP) -kurssi aloittelijoille

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

🧠 Model Context Protocol -kurssin yleiskatsaus

Model Context Protocol (MCP) on huippuluokan kehys, joka standardoi vuorovaikutuksen tekoälymallien ja asiakassovellusten välillä. Tämä avoimen lähdekoodin kurssi 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-kurssin yleiskatsaus

📚 Kurssin rakenne

ModuuliAiheKuvausLinkki
Moduuli 1-3: Perusteet
00Johdatus MCP:henModel Context Protocolin yleiskatsaus ja sen merkitys tekoälyputkistoissaLue lisää
01Keskeiset käsitteetSyvällinen tarkastelu MCP:n keskeisiin käsitteisiinLue lisää
02Turvallisuus MCP:ssäTurvauhat ja parhaat käytännötLue lisää
03MCP:n käyttöönottoYmpäristön asennus, peruspalvelimet/asiakkaat, integrointiLue lisää
Moduuli 3: Ensimmäisen palvelimen ja asiakkaan rakentaminen
3.1Ensimmäinen palvelinLuo ensimmäinen MCP-palvelimesiOpas
3.2Ensimmäinen asiakasKehitä perus MCP-asiakasOpas
3.3Asiakas LLM:lläIntegroi suuret kielimallitOpas
3.4VS Code -integraatioKäytä MCP-palvelimia VS CodessaOpas
3.5stdio-palvelinLuo palvelimia stdio-kuljetuksellaOpas
3.6HTTP-suoratoistoToteuta HTTP-suoratoisto MCP:ssäOpas
3.7AI ToolkitKäytä AI Toolkitia MCP:n kanssaOpas
3.8TestausTestaa MCP-palvelimen toteutustaOpas
3.9KäyttöönottoOta MCP-palvelimet käyttöön tuotannossaOpas
3.10Kehittynyt palvelimen käyttöKäytä kehittyneitä palvelimia edistyneiden ominaisuuksien ja parannetun arkkitehtuurin hyödyntämiseenOpas
3.11Yksinkertainen autentikointiLuku, joka näyttää autentikoinnin alusta alkaen ja RBAC:nOpas
Moduuli 4-5: Käytännön ja edistyneet aiheet
04Käytännön toteutusSDK:t, virheenkorjaus, testaus, uudelleenkäytettävät kehotemallitLue lisää
05Edistyneet aiheet MCP:ssäMonimodaalinen tekoäly, skaalaus, yrityskäyttöLue lisää
5.1Azure-integraatioMCP:n integrointi AzureenOpas
5.2MonimodaalisuusTyöskentely useiden modaliteettien kanssaOpas
5.3OAuth2-demoToteuta OAuth2-autentikointiOpas
5.4JuurikontekstitYmmärrä ja toteuta juurikontekstitOpas
5.5ReititysMCP:n reititysstrategiatOpas
5.6NäytteenottoNäytteenottotekniikat MCP:ssäOpas
5.7SkaalausSkaalaa MCP-toteutuksiaOpas
5.8TurvallisuusKehittyneet turvallisuusharkinnatOpas
5.9VerkkohakuToteuta verkkohakutoiminnotOpas
5.10Reaaliaikainen suoratoistoRakenna reaaliaikainen suoratoistotoimintoOpas
5.11Reaaliaikainen hakuToteuta reaaliaikainen hakuOpas
5.12Entra ID -autentikointiAutentikointi Microsoft Entra ID:lläOpas
5.13Foundry-integraatioIntegrointi Azure AI Foundryn kanssaOpas
5.14KontekstisuunnitteluTekniikat tehokkaaseen kontekstisuunnitteluunOpas
5.15MCP Custom TransportMukautetut kuljetustoteutuksetOpas
Moduuli 6-10: Yhteisö ja parhaat käytännöt
06Yhteisön panoksetKuinka osallistua MCP-ekosysteemiinOpas
07Oivalluksia varhaisesta käyttöönotostaTodelliset toteutustarinatOpas
08MCP:n parhaat käytännötSuorituskyky, vikasietoisuus, resilienssiOpas
09MCP-tapaustutkimuksetKäytännön toteutusesimerkitOpas
10Käytännön työpajaMCP-palvelimen rakentaminen AI ToolkitillaLab
Moduuli 11: MCP-palvelimen käytännön harjoitus
11MCP-palvelimen tietokantaintegraatioKattava 13-laboratorion oppimispolku PostgreSQL-integraatiota vartenLab
11.1JohdantoMCP:n yleiskatsaus tietokantaintegraatiolla ja vähittäisanalytiikan käyttötapauksellaLab 00
11.2YdinarkkitehtuuriMCP-palvelimen arkkitehtuurin, tietokantakerrosten ja turvallisuusmallien ymmärtäminenLab 01
11.3Turvallisuus ja monikäyttöisyysRivitasoinen turvallisuus, autentikointi ja monikäyttäjäinen datan käyttöLab 02
11.4Ympäristön asennusKehitysympäristön, Dockerin ja Azure-resurssien asennusLab 03
11.5Tietokannan suunnitteluPostgreSQL:n asennus, vähittäiskaupan skeeman suunnittelu ja esimerkkidataLab 04
11.6MCP-palvelimen toteutusFastMCP-palvelimen rakentaminen tietokantaintegraatiollaLab 05
11.7Työkalujen kehitysTietokantakyselytyökalujen ja skeeman introspektion luominenLab 06
11.8Semanttinen hakuVektorijoukkojen toteutus Azure OpenAI:n ja pgvectorin avullaLab 07
11.9Testaus ja virheenkorjausTestausstrategiat, virheenkorjaustyökalut ja validointimenetelmätLab 08
11.10VS Code -integraatioVS Code MCP -integraation ja AI Chatin käytön konfigurointiLab 09
11.11JulkaisustrategiatDocker-julkaisu, Azure Container Apps ja skaalausnäkökohdatLab 10
11.12SeurantaApplication Insights, lokitus ja suorituskyvyn seurantaLab 11
11.13Parhaat käytännötSuorituskyvyn optimointi, turvallisuuden vahvistaminen ja tuotantovinkitLab 12

💻 Esimerkkikoodiprojektit

Perustason MCP-laskimen esimerkit

KieliKuvausLinkki
C#MCP-palvelimen esimerkkiNäytä koodi
JavaMCP-laskinNäytä koodi
JavaScriptMCP-demoNäytä koodi
PythonMCP-palvelinNäytä koodi
TypeScriptMCP-esimerkkiNäytä koodi
RustMCP-esimerkkiNäytä koodi

Kehittyneet MCP-toteutukset

KieliKuvausLinkki
C#Kehittynyt esimerkkiNäytä koodi
Java SpringilläContainer App -esimerkkiNäytä koodi
JavaScriptKehittynyt esimerkkiNäytä koodi
PythonMonimutkainen toteutusNäytä koodi
TypeScriptContainer-esimerkkiNäytä koodi

🎯 MCP:n oppimisen edellytykset

Jotta saat tästä oppimateriaalista kaiken irti, sinulla tulisi olla:

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

  • Asiakas-palvelin-mallin ja API:iden ymmärrys

  • REST- ja HTTP-konseptien tuntemus

  • (Valinnainen) Taustatietoa AI/ML-konsepteista

  • Liity yhteisökeskusteluihimme saadaksesi tukea

📚 Opas ja resurssit

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

Opas

Kattava Opas on saatavilla auttamaan sinua navigoimaan tässä arkistossa. Opas sisältää:

  • Visuaalisen opintokartan, joka näyttää kaikki käsitellyt aiheet
  • Yksityiskohtaisen jaon jokaisesta arkiston osasta
  • Ohjeet esimerkkiprojektien käyttöön
  • Suositellut oppimispolut eri taitotasoille
  • Lisäresursseja oppimismatkan 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 tässä oppaassa sisältää:

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

Tapahtumat

MCP Dev Days heinäkuu 2025

➡️Katso tallenteena - MCP Dev Days

Valmistaudu kahden päivän syvälliseen tekniseen oppimiseen, yhteisön verkostoitumiseen ja käytännön harjoitteluun MCP Dev Days -tapahtumassa, joka on virtuaalinen tapahtuma Model Context Protocolille (MCP) — nousevalle standardille, 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.

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

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 muokkaamiseksi.
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ä.

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

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 tulevaisuuden MCP-ratkaisujen rakentamiseen.

MCP Boot Camp elokuu 2025

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

➡️Katso tallenteena MCP Bootcamp | Englanti

➡️Katso tallenteena MCP Bootcamp | Brasilia

➡️Katso tallenteena MCP Bootcamp | Espanja

Opitaan MCP:tä C#:llä - Opetusvideosarja

Opitaan Model Context Protocolista (MCP), huippuluokan kehyksestä, joka on suunniteltu standardoimaan vuorovaikutukset AI-mallien ja asiakassovellusten välillä. Tässä aloittelijaystävällisessä sessiossa esittelemme MCP:n ja opastamme sinua ensimmäisen MCP-palvelimen luomisessa.

C#: https://aka.ms/letslearnmcp-csharp

Java: https://aka.ms/letslearnmcp-java

JavaScript: https://aka.ms/letslearnmcp-javascript

Python: https://aka.ms/letslearnmcp-python

🌟 Yhteisön kiitokset

Kiitos 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-tiedostosta.

🤝 Osallistumisohjeet

Tämä projekti toivottaa tervetulleeksi osallistumiset ja ehdotukset. Useimmat osallistumiset edellyttävät, että hyväksyt
Contributor License Agreement (CLA) -sopimuksen, jossa vakuutat, että sinulla on oikeus antaa meille
oikeudet käyttää osallistumistasi. 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 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 Conduct.
Lisätietoja löytyy Code of Conduct FAQ-sivulta tai
ota yhteyttä opencode@microsoft.com, jos sinulla on lisäkysymyksiä tai kommentteja.

📂 Arkiston rakenne

Arkisto on järjestetty seuraavasti:

  • Ydinopetusohjelma (00-11): Pääsisältö, joka on järjestetty yhdentoista peräkkäisen moduulin mukaan, sisältäen kattavat tietokantaintegraatiolaboratoriot
  • 11-MCPServerHandsOnLabs/: Täydellinen 13-laboratorion oppimispolku tuotantovalmiiden MCP-palvelimien rakentamiseen PostgreSQL-integraatiolla
  • 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 oppimateriaaleihin
  • 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 luvallinen käyttö on sidottu ja sen tulee noudattaa Microsoftin tavaramerkki- ja brändiohjeita. Microsoftin tavaramerkkien tai logojen käyttö tämän projektin muokatuissa versioissa ei saa aiheuttaa sekaannusta tai antaa ymmärtää, että Microsoft tukee projektia. Kolmansien osapuolien tavaramerkkien tai logojen käyttö on sidottu kyseisten osapuolien käytäntöihin.

Apua ongelmatilanteisiin

Jos jäät jumiin tai sinulla on kysymyksiä tekoälysovellusten rakentamisesta, liity:

Azure AI Foundry Discord

Jos sinulla on palautetta tuotteesta tai kohtaat virheitä rakentamisen aikana, vieraile:

Azure AI Foundry Developer Forum


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ä. Tärkeissä tiedoissa suositellaan ammattimaista ihmiskäännöstä. Emme ole vastuussa väärinkäsityksistä tai virhetulkinnoista, jotka johtuvat tämän käännöksen käytöstä.