Seuraa näitä ohjeita päästäksesi alkuun näiden resurssien käytössä:
- Haarauta repositorio: Klikkaa
- Kloonaa repositorio:
git clone https://github.com/microsoft/mcp-for-beginners.git
- 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-dokumentaatio – Yksityiskohtaiset opetusohjelmat ja käyttäjäoppaat
- 📜 MCP-määrittely – Protokollan arkkitehtuuri ja tekniset viitteet
- 📜 Alkuperäinen MCP-määrittely – Vanhemmat tekniset viitteet (saattaa sisältää lisätietoja)
- 🧑💻 MCP GitHub -repositorio – Avoimen lähdekoodin SDK:t, työkalut ja koodiesimerkit
- 🌐 MCP-yhteisö – Liity keskusteluihin ja osallistu yhteisöön
🧭 MCP-kurssin yleiskatsaus
📚 Kurssin rakenne
Moduuli | Aihe | Kuvaus | Linkki |
---|---|---|---|
Moduuli 1-3: Perusteet | |||
00 | Johdatus MCP:hen | Model Context Protocolin yleiskatsaus ja sen merkitys tekoälyputkistoissa | Lue lisää |
01 | Keskeiset käsitteet | Syvällinen tarkastelu 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 | 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 |
3.10 | Kehittynyt palvelimen käyttö | Käytä kehittyneitä palvelimia edistyneiden ominaisuuksien ja parannetun arkkitehtuurin hyödyntämiseen | Opas |
3.11 | Yksinkertainen autentikointi | Luku, joka näyttää autentikoinnin alusta alkaen ja RBAC:n | 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 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 | Toteuta OAuth2-autentikointi | Opas |
5.4 | Juurikontekstit | Ymmärrä ja toteuta juurikontekstit | Opas |
5.5 | Reititys | MCP:n reititysstrategiat | Opas |
5.6 | Näytteenotto | Näytteenottotekniikat MCP:ssä | Opas |
5.7 | Skaalaus | Skaalaa MCP-toteutuksia | Opas |
5.8 | Turvallisuus | Kehittyneet turvallisuusharkinnat | Opas |
5.9 | Verkkohaku | Toteuta verkkohakutoiminnot | 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 Foundryn kanssa | Opas |
5.14 | Kontekstisuunnittelu | Tekniikat tehokkaaseen kontekstisuunnitteluun | Opas |
5.15 | MCP Custom Transport | Mukautetut kuljetustoteutukset | 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, resilienssi | Opas |
09 | MCP-tapaustutkimukset | Käytännön toteutusesimerkit | Opas |
10 | Käytännön työpaja | MCP-palvelimen rakentaminen AI Toolkitilla | Lab |
Moduuli 11: MCP-palvelimen käytännön harjoitus | |||
11 | MCP-palvelimen tietokantaintegraatio | Kattava 13-laboratorion oppimispolku PostgreSQL-integraatiota varten | Lab |
11.1 | Johdanto | MCP:n yleiskatsaus tietokantaintegraatiolla ja vähittäisanalytiikan käyttötapauksella | Lab 00 |
11.2 | Ydinarkkitehtuuri | MCP-palvelimen arkkitehtuurin, tietokantakerrosten ja turvallisuusmallien ymmärtäminen | Lab 01 |
11.3 | Turvallisuus ja monikäyttöisyys | Rivitasoinen turvallisuus, autentikointi ja monikäyttäjäinen datan käyttö | Lab 02 |
11.4 | Ympäristön asennus | Kehitysympäristön, Dockerin ja Azure-resurssien asennus | Lab 03 |
11.5 | Tietokannan suunnittelu | PostgreSQL:n asennus, vähittäiskaupan skeeman suunnittelu ja esimerkkidata | Lab 04 |
11.6 | MCP-palvelimen toteutus | FastMCP-palvelimen rakentaminen tietokantaintegraatiolla | Lab 05 |
11.7 | Työkalujen kehitys | Tietokantakyselytyökalujen ja skeeman introspektion luominen | Lab 06 |
11.8 | Semanttinen haku | Vektorijoukkojen toteutus Azure OpenAI:n ja pgvectorin avulla | Lab 07 |
11.9 | Testaus ja virheenkorjaus | Testausstrategiat, virheenkorjaustyökalut ja validointimenetelmät | Lab 08 |
11.10 | VS Code -integraatio | VS Code MCP -integraation ja AI Chatin käytön konfigurointi | Lab 09 |
11.11 | Julkaisustrategiat | Docker-julkaisu, Azure Container Apps ja skaalausnäkökohdat | Lab 10 |
11.12 | Seuranta | Application Insights, lokitus ja suorituskyvyn seuranta | Lab 11 |
11.13 | Parhaat käytännöt | Suorituskyvyn optimointi, turvallisuuden vahvistaminen ja tuotantovinkit | Lab 12 |
💻 Esimerkkikoodiprojektit
Perustason MCP-laskimen esimerkit
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 |
Rust | MCP-esimerkki | Näytä koodi |
Kehittyneet MCP-toteutukset
Kieli | Kuvaus | Linkki |
---|---|---|
C# | Kehittynyt esimerkki | Näytä koodi |
Java Springillä | Container App -esimerkki | Näytä koodi |
JavaScript | Kehittynyt esimerkki | Näytä koodi |
Python | Monimutkainen toteutus | Näytä koodi |
TypeScript | Container-esimerkki | Nä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ää:
- Selkeät selitykset MCP-konsepteista
- Live-koodiesimerkit useilla kielillä
- Harjoituksia MCP-sovellusten rakentamiseen
- 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:
- UUSI Edge AI For Beginners
- AI Agents For Beginners
- Generative AI for Beginners using .NET
- Generative AI for Beginners using JavaScript
- Generative AI for Beginners
- Generative AI for Beginners using Java
- ML for Beginners
- Data Science for Beginners
- AI for Beginners
- Cybersecurity for Beginners
- Web Dev for Beginners
- IoT for Beginners
- XR Development for Beginners
- Mastering GitHub Copilot for AI Paired Programming
- GitHub Copilotin hallinta C#/.NET-kehittäjille
- Valitse oma Copilot-seikkailusi
™️ 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:
Jos sinulla on palautetta tuotteesta tai kohtaat virheitä rakentamisen aikana, vieraile:
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ä.