Ta študijski vodič ponuja pregled strukture in vsebine repozitorija za učni načrt "Model Context Protocol (MCP) za začetnike". Uporabite ta vodič za učinkovito navigacijo po repozitoriju in kar najbolj izkoristite razpoložljive vire.
Model Context Protocol (MCP) je standardiziran okvir za interakcije med AI modeli in odjemalskimi aplikacijami. Sprva ga je ustvaril Anthropic, zdaj pa ga vzdržuje širša MCP skupnost prek uradne GitHub organizacije. Ta repozitorij ponuja celovit učni načrt z praktičnimi primeri kode v C#, Javi, JavaScriptu, Pythonu in TypeScriptu, namenjen razvijalcem AI, sistemskim arhitektom in programskim inženirjem.
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)
Repozitorij je organiziran v deset glavnih sklopov, ki se osredotočajo na različne vidike MCP:
-
Uvod (00-Introduction/)
- Pregled Model Context Protocol
- Zakaj je standardizacija pomembna v AI procesih
- Praktični primeri uporabe in koristi
-
Osnovni pojmi (01-CoreConcepts/)
- Arhitektura klient-strežnik
- Ključne komponente protokola
- Vzorce sporočanja v MCP
-
Varnost (02-Security/)
- Varnostne grožnje v sistemih, ki temeljijo na MCP
- Najboljše prakse za varno implementacijo
- Strategije avtentikacije in avtorizacije
-
Začetek dela (03-GettingStarted/)
- Nastavitev in konfiguracija okolja
- Ustvarjanje osnovnih MCP strežnikov in odjemalcev
- Integracija z obstoječimi aplikacijami
- Vključuje razdelke za:
- Prvo implementacijo strežnika
- Razvoj odjemalca
- Integracijo LLM odjemalca
- Integracijo v VS Code
- Strežnik Server-Sent Events (SSE)
- HTTP pretakanje
- Integracijo AI Toolkit
- Strategije testiranja
- Navodila za nameščanje
-
Praktična implementacija (04-PracticalImplementation/)
- Uporaba SDK-jev v različnih programskih jezikih
- Tehnike odpravljanja napak, testiranja in validacije
- Oblikovanje ponovno uporabnih predlog in delovnih tokov
- Vzorčni projekti z implementacijskimi primeri
-
Napredne teme (05-AdvancedTopics/)
- Tehnike kontekstnega inženiringa
- Integracija Foundry agenta
- Večmodalni AI delovni tokovi
- Demonstracije OAuth2 avtentikacije
- Iskanje v realnem času
- Pretakanje v realnem času
- Implementacija root kontekstov
- Strategije usmerjanja
- Tehnike vzorčenja
- Pristopi k skaliranju
- Varnostni vidiki
- Integracija varnosti Entra ID
- Integracija spletnega iskanja
-
Prispevki skupnosti (06-CommunityContributions/)
- Kako prispevati k kodi in dokumentaciji
- Sodelovanje prek GitHub-a
- Izboljšave in povratne informacije, ki jih vodi skupnost
- Uporaba različnih MCP odjemalcev (Claude Desktop, Cline, VSCode)
- Delo s priljubljenimi MCP strežniki, vključno z generiranjem slik
-
Lekcije iz zgodnje uporabe (07-LessonsfromEarlyAdoption/)
- Resnični primeri implementacij in uspešne zgodbe
- Gradnja in uvajanje rešitev na osnovi MCP
- Trend in prihodnja razvojna pot
-
Najboljše prakse (08-BestPractices/)
- Nastavitve za izboljšanje zmogljivosti in optimizacija
- Oblikovanje odpornosti MCP sistemov
- Strategije testiranja in odpornosti
-
Študije primerov (09-CaseStudy/)
- Študija primera: integracija Azure API Management
- Študija primera: implementacija potovalnega agenta
- Študija primera: integracija Azure DevOps z YouTube
- Primeri implementacij z obsežno dokumentacijo
-
Praktična delavnica (10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/)
- Celovita praktična delavnica, ki združuje MCP z AI Toolkit
- Gradnja inteligentnih aplikacij, ki povezujejo AI modele z orodji iz resničnega sveta
- Praktični moduli, ki pokrivajo osnove, razvoj prilagojenih strežnikov in strategije uvajanja v produkcijo
- Učenje na osnovi laboratorijskih vaj s podrobnimi navodili
Repozitorij vključuje podporne vire:
- Mapa slik: vsebuje diagrame in ilustracije, uporabljene v učnem načrtu
- Prevodi: podpora več jezikom z avtomatiziranimi prevodi dokumentacije
- Uradni MCP viri:
- Učenje po vrsti: sledite poglavjem po vrstnem redu (od 00 do 10) za strukturirano učenje.
- Osredotočenost na jezik: če vas zanima določen programski jezik, preglejte mape s primeri za implementacije v izbranem jeziku.
- Praktična implementacija: začnite z razdelkom "Začetek dela" za nastavitev okolja in ustvarjanje prvega MCP strežnika in odjemalca.
- Napredno raziskovanje: ko obvladate osnove, se poglobite v napredne teme za širitev znanja.
- Sodelovanje v skupnosti: pridružite se MCP skupnosti prek GitHub razprav in Discord kanalov za povezovanje z eksperti in razvijalci.
Učni načrt pokriva različne MCP odjemalce in orodja:
-
Uradni odjemalci:
- Visual Studio Code
- MCP v Visual Studio Code
- Claude Desktop
- Claude v VSCode
- Claude API
-
Skupnostni odjemalci:
- Cline (terminalski)
- Cursor (urejevalnik kode)
- ChatMCP
- Windsurf
-
Orodja za upravljanje MCP:
- MCP CLI
- MCP Manager
- MCP Linker
- MCP Router
Repozitorij predstavlja različne MCP strežnike, med drugim:
-
Uradni referenčni strežniki:
- Filesystem
- Fetch
- Memory
- Sequential Thinking
-
Generiranje slik:
- Azure OpenAI DALL-E 3
- Stable Diffusion WebUI
- Replicate
-
Razvojna orodja:
- Git MCP
- Terminal Control
- Code Assistant
-
Specializirani strežniki:
- Salesforce
- Microsoft Teams
- Jira & Confluence
Ta repozitorij sprejema prispevke skupnosti. Za navodila, kako učinkovito prispevati k MCP ekosistemu, si oglejte razdelek Prispevki skupnosti.
| Datum | Spremembe |
|---|---|
| 16. julij 2025 | - Posodobljena struktura repozitorija, da odraža trenutno vsebino - Dodan razdelek MCP odjemalci in orodja - Dodan razdelek Priljubljeni MCP strežniki - Posodobljena vizualna karta učnega načrta z vsemi trenutnimi temami - Izboljšan razdelek Napredne teme z vsemi specializiranimi področji - Posodobljene študije primerov z dejanskimi primeri - Pojasnjen izvor MCP kot delo Anthropic |
| 11. junij 2025 | - Prvotna izdelava študijskega vodiča - Dodana vizualna karta učnega načrta - Opisana struktura repozitorija - Vključeni vzorčni projekti in dodatni viri |
Ta študijski vodič je bil posodobljen 16. julija 2025 in ponuja pregled repozitorija do tega datuma. Vsebina repozitorija se lahko po tem datumu posodablja.
Omejitev odgovornosti:
Ta dokument je bil preveden z uporabo AI prevajalske storitve Co-op Translator. Čeprav si prizadevamo za natančnost, vas opozarjamo, da avtomatizirani prevodi lahko vsebujejo napake ali netočnosti. Izvirni dokument v njegovem izvirnem jeziku velja za avtoritativni vir. Za pomembne informacije priporočamo strokovni človeški prevod. Za morebitna nesporazume ali napačne interpretacije, ki izhajajo iz uporabe tega prevoda, ne odgovarjamo.