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 Benefits)
(Real-world Use Cases)
(AI Integration Fundamentals)
01. Core Concepts
::icon(fa fa-puzzle-piece)
(Client-Server Architecture)
(Protocol Components)
(Messaging Patterns)
(Transport Mechanisms)
02. Security
::icon(fa fa-shield)
(AI-Specific Threats)
(Best Practices 2025)
(Azure Content Safety)
(Auth & Authorization)
(Microsoft Prompt Shields)
03. Getting Started
::icon(fa fa-rocket)
(First Server Implementation)
(Client Development)
(LLM Client Integration)
(VS Code Extensions)
(SSE Server Setup)
(HTTP Streaming)
(AI Toolkit Integration)
(Testing Frameworks)
(Deployment Strategies)
04. Practical Implementation
::icon(fa fa-code)
(Multi-Language SDKs)
(Testing & Debugging)
(Prompt Templates)
(Sample Projects)
(Production Patterns)
05. Advanced Topics
::icon(fa fa-graduation-cap)
(Context Engineering)
(Foundry Agent Integration)
(Multi-modal AI Workflows)
(OAuth2 Authentication)
(Real-time Search)
(Streaming Protocols)
(Root Contexts)
(Routing Strategies)
(Sampling Techniques)
(Scaling Solutions)
(Security Hardening)
(Entra ID Integration)
(Web Search MCP)
06. Community
::icon(fa fa-users)
(Code Contributions)
(Documentation)
(MCP Client Ecosystem)
(MCP Server Registry)
(Image Generation Tools)
(GitHub Collaboration)
07. Early Adoption
::icon(fa fa-lightbulb)
(Production Deployments)
(Microsoft MCP Servers)
(Azure MCP Service)
(Enterprise Case Studies)
(Future Roadmap)
08. Best Practices
::icon(fa fa-check)
(Performance Optimization)
(Fault Tolerance)
(System Resilience)
(Monitoring & Observability)
09. Case Studies
::icon(fa fa-file-text)
(Azure API Management)
(AI Travel Agent)
(Azure DevOps Integration)
(Documentation MCP)
(Real-world Implementations)
10. Hands-on Workshop
::icon(fa fa-laptop)
(MCP Server Fundamentals)
(Advanced Development)
(AI Toolkit Integration)
(Production Deployment)
(4-Lab Structure)
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
- Autentikointi- ja valtuutusstrategiat
- Laaja turvallisuusdokumentaatio:
- MCP Security Best Practices 2025
- Azure Content Safety Implementation Guide
- MCP Security Controls and Techniques
- MCP Best Practices Quick Reference
- Keskeiset turvallisuusaiheet:
- Prompt-injektio ja työkalujen myrkytys
- Istunnon kaappaus ja confused deputy -ongelmat
- Tokenin läpivientiin liittyvät haavoittuvuudet
- Liialliset oikeudet ja pääsynhallinta
- Tekoälykomponenttien toimitusketjun turvallisuus
- Microsoft Prompt Shields -integraatio
-
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
- 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 toteutuksineen
-
Edistyneet aiheet (05-AdvancedTopics/)
- Kontekstisuunnittelutekniikat
- Foundry-agentin integrointi
- Monimodaaliset tekoälytyönkulut
- OAuth2-autentikointiesimerkit
- Reaaliaikaiset hakutoiminnot
- Reaaliaikainen suoratoisto
- Root-kontekstien toteutus
- Reititysstrategiat
- Otantamenetelmät
- Skaalausratkaisut
- Turvallisuusnäkökohdat
- Entra ID -turvallisuusintegraatio
- Verkkohakuintegraatio
-
Yhteisön panokset (06-CommunityContributions/)
- Kuinka osallistua koodilla ja dokumentaatiolla
- Yhteistyö GitHubin kautta
- Yhteisön kehittämät parannukset ja palaute
- Erilaisten MCP-asiakkaiden käyttö (Claude Desktop, Cline, VSCode)
- Työskentely suosittujen MCP-palvelimien kanssa, mukaan lukien kuvageneraattorit
-
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
- Microsoft MCP Servers Guide: Kattava opas 10 tuotantovalmiiseen Microsoft MCP -palvelimeen, mukaan lukien:
- Microsoft Learn Docs MCP Server
- Azure MCP Server (yli 15 erikoiskonetta)
- GitHub MCP Server
- Azure DevOps MCP Server
- MarkItDown MCP Server
- SQL Server MCP Server
- Playwright MCP Server
- Dev Box MCP Server
- Azure AI Foundry MCP Server
- Microsoft 365 Agents Toolkit MCP Server
-
Parhaat käytännöt (08-BestPractices/)
- Suorituskyvyn säätö ja optimointi
- Vikasietoisten MCP-järjestelmien suunnittelu
- Testaus- ja resilienssistrategiat
-
Tapaustutkimukset (09-CaseStudy/)
- Azure API Management -integraatioesimerkki
- Matkatoimiston toteutusesimerkki
- Azure DevOps -integraatio YouTube-päivityksillä
- Dokumentaation MCP-toteutusesimerkit
- 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 palvelinkehityksen ja tuotantoon viennin strategiat
- Lab-rakenne:
- Lab 1: MCP-palvelimen perusteet
- Lab 2: Edistynyt MCP-palvelinkehitys
- Lab 3: AI Toolkit -integraatio
- Lab 4: Tuotantoon vienti ja skaalaus
- Lab-pohjainen oppiminen vaihe vaiheelta ohjein
Repositoriossa on tukimateriaaleja:
- Images-kansio: Sisältää kaavioita ja kuvituksia, joita käytetään opetussuunnitelmassa
- Käännökset: Monikielinen tuki ja automaattiset dokumentaation käännökset
- Viralliset MCP-resurssit:
- Järjestelmällinen opiskelu: Seuraa lukuja järjestyksessä (00–10) saadaksesi rakenteellisen oppimiskokemuksen.
- Kielikohtainen painotus: Jos olet kiinnostunut tietystä ohjelmointikielestä, tutustu esimerkkihakemistoihin oman kielesi toteutuksia varten.
- Käytännön toteutus: Aloita "Getting Started" -osiosta, jossa opit asentamaan ympäristön ja luomaan ensimmäisen MCP-palvelimen ja -asiakkaan.
- Edistynyt tutkimus: Kun perusteet ovat hallussa, siirry 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.
Opetussuunnitelma 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, mukaan lukien:
-
Viralliset Microsoft MCP -palvelimet:
- Microsoft Learn Docs MCP Server
- Azure MCP Server (yli 15 erikoiskonetta)
- GitHub MCP Server
- Azure DevOps MCP Server
- MarkItDown MCP Server
- SQL Server MCP Server
- Playwright MCP Server
- Dev Box MCP Server
- Azure AI Foundry MCP Server
- Microsoft 365 Agents Toolkit MCP Server
-
Viralliset referenssipalvelimet:
- Filesystem
- Fetch
- Memory
- Sequential Thinking
-
Kuvagenerointi:
- 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 |
|---|---|
| 18. heinäkuuta 2025 | - Päivitetty repositorion rakenne sisältämään Microsoft MCP Servers Guide - Lisätty kattava lista 10 tuotantovalmiista Microsoft MCP -palvelimesta - Parannettu Suosittuja MCP-palvelimia -osiota virallisilla Microsoft MCP -palvelimilla - Päivitetty Tapaustutkimukset-osio todellisilla tiedostoesimerkeillä - Lisätty Lab-rakenteen tiedot Käytännön työpajaan |
| 16. heinäkuuta 2025 | - Päivitetty repositorion rakenne vastaamaan nykyistä sisältöä - Lisätty MCP-asiakkaat ja työkalut -osio - Lisätty Suosittuja MCP-palvelimia -osio - Päivitetty Visuaalinen opetussuunnitelmakartta kaikilla nykyisillä aiheilla - Parannettu 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 18. 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äiskielellä 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.