Tämä opas tarjoaa yleiskatsauksen "Model Context Protocol (MCP) for Beginners" -oppimateriaalin repositorion rakenteesta ja sisällöstä. Käytä tätä opasta navigoidaksesi repositoriossa tehokkaasti ja hyödyntääksesi saatavilla olevat resurssit parhaalla mahdollisella tavalla.
Model Context Protocol (MCP) on standardoitu kehys tekoälymallien ja asiakasohjelmien välisille vuorovaikutuksille. Alun perin Anthropicin luoma MCP on nyt MCP-yhteisön ylläpitämä virallisen GitHub-organisaation kautta. Tämä repositorio tarjoaa kattavan opetussuunnitelman, jossa on käytännön koodiesimerkkejä C#:lla, Javalla, JavaScriptillä, Pythonilla ja TypeScriptilä, suunnattu tekoälykehittäjille, järjestelmäarkkitehdeille ja ohjelmistoinsinööreille.
mindmap
root((MCP for Beginners))
00. Introduction
::icon(fa fa-book)
(Protocol Overview)
(Standardization)
(Use Cases)
01. Core Concepts
::icon(fa fa-puzzle-piece)
(Client-Server Architecture)
(Protocol Components)
(Messaging Patterns)
02. Security
::icon(fa fa-shield)
(Threat Models)
(Best Practices)
(Auth Strategies)
03. Getting Started
::icon(fa fa-rocket)
(First Server)
(Client)
(LLM Client)
(VS Code Integration)
(SSE Server)
(HTTP Streaming)
(AI Toolkit)
(Testing)
(Deployment)
04. Practical Implementation
::icon(fa fa-code)
(SDKs)
(Testing/Debugging)
(Prompt Templates)
(Sample Projects)
05. Advanced Topics
::icon(fa fa-graduation-cap)
(Context Engineering)
(Foundry Integration)
(Multi-modal AI)
(OAuth2 Demo)
(Real-time Search)
(Streaming)
(Root Contexts)
(Routing)
(Sampling)
(Scaling)
(Security)
(Entra ID)
(Web Search)
06. Community
::icon(fa fa-users)
(Code Contributions)
(Documentation)
(MCP Clients)
(MCP Servers)
(Image Generation)
07. Early Adoption
::icon(fa fa-lightbulb)
(Real-world Examples)
(Deployment Stories)
(Future Roadmap)
08. Best Practices
::icon(fa fa-check)
(Performance)
(Fault Tolerance)
(Resilience)
09. Case Studies
::icon(fa fa-file-text)
(API Management)
(Travel Agent)
(Azure DevOps)
(Documentation MCP)
10. Hands-on Workshop
::icon(fa fa-laptop)
(AI Toolkit Integration)
(Custom Server Development)
(Production Deployment)
Repositorio on jaettu kymmeneen pääosioon, jotka käsittelevät MCP:n eri osa-alueita:
-
Johdanto (00-Introduction/)
- Model Context Protocolin yleiskatsaus
- Miksi standardisointi on tärkeää tekoälyputkissa
- Käytännön käyttötapaukset ja hyödyt
-
Peruskäsitteet (01-CoreConcepts/)
- Asiakas-palvelin-arkkitehtuuri
- Protokollan keskeiset osat
- Viestintämallit MCP:ssä
-
Turvallisuus (02-Security/)
- Turvauhat MCP-pohjaisissa järjestelmissä
- Parhaat käytännöt turvallisten toteutusten varmistamiseksi
- Todennus- ja valtuutusstrategiat
-
Aloittaminen (03-GettingStarted/)
- Ympäristön asennus ja konfigurointi
- Perus MCP-palvelimien ja -asiakkaiden luominen
- Integrointi olemassa oleviin sovelluksiin
- Sisältää osiot:
- Ensimmäinen palvelin toteutus
- Asiakasohjelman kehitys
- LLM-asiakasintegraatio
- VS Code -integraatio
- Server-Sent Events (SSE) -palvelin
- HTTP-suoratoisto
- AI Toolkit -integraatio
- Testausstrategiat
- Julkaisun ohjeet
-
Käytännön toteutus (04-PracticalImplementation/)
- SDK:iden käyttö eri ohjelmointikielillä
- Virheenkorjaus, testaus ja validointimenetelmät
- Uudelleenkäytettävien prompt-mallien ja työnkulkujen luominen
- Esimerkkiprojekteja toteutusesimerkkien kera
-
Edistyneet aiheet (05-AdvancedTopics/)
- Kontekstisuunnittelutekniikat
- Foundry-agentin integrointi
- Monimodaaliset tekoälytyönkulut
- OAuth2-todennuksen demot
- Reaaliaikaiset hakutoiminnot
- Reaaliaikainen suoratoisto
- Root-kontekstien toteutus
- Reititysstrategiat
- Otantatekniikat
- Skaalausratkaisut
- Turvallisuusnäkökohdat
- Entra ID -turvaintegraatio
- Verkkohakuintegraatio
-
Yhteisön panokset (06-CommunityContributions/)
- Kuinka osallistua koodilla ja dokumentaatiolla
- Yhteistyö GitHubin kautta
- Yhteisön vetämät parannukset ja palaute
- Erilaisten MCP-asiakkaiden käyttö (Claude Desktop, Cline, VSCode)
- Suosittujen MCP-palvelimien käyttö, mukaan lukien kuvanluonti
-
Varhaisen käyttöönoton opit (07-LessonsfromEarlyAdoption/)
- Käytännön toteutukset ja menestystarinat
- MCP-pohjaisten ratkaisujen rakentaminen ja käyttöönotto
- Trendit ja tulevaisuuden tiekartta
-
Parhaat käytännöt (08-BestPractices/)
- Suorituskyvyn säätö ja optimointi
- Vikasietoisten MCP-järjestelmien suunnittelu
- Testaus- ja resilienssistrategiat
-
Tapaustutkimukset (09-CaseStudy/)
- Tapaustutkimus: Azure API Management -integraatio
- Tapaustutkimus: Matkatoimiston toteutus
- Tapaustutkimus: Azure DevOps -integraatio YouTuben kanssa
- Toteutusesimerkit yksityiskohtaisella dokumentaatiolla
-
Käytännön työpaja (10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/)
- Kattava käytännön työpaja, joka yhdistää MCP:n ja AI Toolkitin
- Älykkäiden sovellusten rakentaminen, jotka yhdistävät tekoälymallit todellisiin työkaluihin
- Käytännön moduulit, jotka kattavat perusteet, räätälöidyn palvelimen kehityksen ja tuotantoon siirtymisen strategiat
- Laboratoriopohjainen oppimismenetelmä vaiheittaisilla ohjeilla
Repositoriossa on tukimateriaaleja:
- Kuvat-kansio: Sisältää kaavioita ja kuvituksia, joita käytetään opetussuunnitelmassa
- Käännökset: Monikielinen tuki dokumentaation automaattisilla käännöksillä
- Viralliset MCP-resurssit:
- Järjestelmällinen opiskelu: Seuraa lukuja järjestyksessä (00–10) saadaksesi rakenteellisen oppimiskokemuksen.
- Kielikohtainen painotus: Jos olet kiinnostunut tietystä ohjelmointikielestä, tutustu esimerkkikansioihin oman kielesi toteutusten löytämiseksi.
- Käytännön toteutus: Aloita "Aloittaminen" -osiosta, jossa opit ympäristön pystytyksen ja ensimmäisen MCP-palvelimen ja -asiakkaan luomisen.
- Edistynyt tutkimus: Kun perusteet ovat hallussa, sukella edistyneisiin aiheisiin laajentaaksesi osaamistasi.
- Yhteisön osallistuminen: Liity MCP-yhteisöön GitHub-keskustelujen ja Discord-kanavien kautta, jotta voit verkostoitua asiantuntijoiden ja muiden kehittäjien kanssa.
Oppimateriaali kattaa erilaisia MCP-asiakkaita ja työkaluja:
-
Viralliset asiakkaat:
- Visual Studio Code
- MCP Visual Studio Codessa
- Claude Desktop
- Claude VSCodessa
- Claude API
-
Yhteisön asiakkaat:
- Cline (päätteeseen perustuva)
- Cursor (koodieditori)
- ChatMCP
- Windsurf
-
MCP-hallintatyökalut:
- MCP CLI
- MCP Manager
- MCP Linker
- MCP Router
Repositoriossa esitellään erilaisia MCP-palvelimia, kuten:
-
Viralliset referenssipalvelimet:
- Filesystem
- Fetch
- Memory
- Sequential Thinking
-
Kuvageneraattorit:
- Azure OpenAI DALL-E 3
- Stable Diffusion WebUI
- Replicate
-
Kehitystyökalut:
- Git MCP
- Terminal Control
- Code Assistant
-
Erikoistuneet palvelimet:
- Salesforce
- Microsoft Teams
- Jira & Confluence
Tämä repositorio toivottaa yhteisön panokset tervetulleiksi. Katso Yhteisön panokset -osio saadaksesi ohjeita siitä, miten voit osallistua MCP-ekosysteemin kehittämiseen tehokkaasti.
| Päivämäärä | Muutokset |
|---|---|
| 16. heinäkuuta 2025 | - Päivitetty repositorion rakenne vastaamaan nykyistä sisältöä - Lisätty MCP-asiakkaat ja työkalut -osio - Lisätty Suositut MCP-palvelimet -osio - Päivitetty Visuaalinen opetussuunnitelmakartta kaikilla nykyisillä aiheilla - Laajennettu Edistyneet aiheet -osiota kaikilla erikoisalueilla - Päivitetty Tapaustutkimukset vastaamaan todellisia esimerkkejä - Selvennetty MCP:n alkuperä Anthropicin luomana |
| 11. kesäkuuta 2025 | - Opas luotu alun perin - Lisätty Visuaalinen opetussuunnitelmakartta - Kuvattu repositorion rakenne - Sisällytetty esimerkkiprojekteja ja lisäresursseja |
Tämä opas päivitettiin 16. heinäkuuta 2025 ja se tarjoaa yleiskatsauksen repositoriosta kyseisenä päivänä. Repositorion sisältöä voidaan päivittää tämän jälkeen.
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äisellä kielellä tulee pitää virallisena lähteenä. Tärkeissä tiedoissa suositellaan ammattimaista ihmiskäännöstä. Emme ole vastuussa tämän käännöksen käytöstä aiheutuvista väärinymmärryksistä tai tulkinnoista.