Urmați acești pași pentru a începe să utilizați aceste resurse:
- Fork la depozit: Faceți clic pe
- Clonați depozitul:
git clone https://github.com/microsoft/mcp-for-beginners.git - Alăturați-vă
Arabic | Bengali | Bulgarian | Burmese (Myanmar) | Chinese (Simplified) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Macau) | Chinese (Traditional, Taiwan) | Croatian | Czech | Danish | Dutch | Estonian | Finnish | French | German | Greek | Hebrew | Hindi | Hungarian | Indonesian | Italian | Japanese | Kannada | Khmer | Korean | Lithuanian | Malay | Malayalam | Marathi | Nepali | Nigerian Pidgin | Norwegian | Persian (Farsi) | Polish | Portuguese (Brazil) | Portuguese (Portugal) | Punjabi (Gurmukhi) | Romanian | Russian | Serbian (Cyrillic) | Slovak | Slovenian | Spanish | Swahili | Swedish | Tagalog (Filipino) | Tamil | Telugu | Thai | Turkish | Ukrainian | Urdu | Vietnamese
Preferi să clonezi local?
Acest depozit include peste 50 de traduceri în diferite limbi, ceea ce crește semnificativ dimensiunea descărcării. Pentru a clona fără traduceri, folosește sparse checkout:
Bash / macOS / Linux:
git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git cd mcp-for-beginners git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'CMD (Windows):
git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git cd mcp-for-beginners git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"Aceasta îți oferă tot ce ai nevoie pentru a parcurge cursul cu o descărcare mult mai rapidă.
Bine ai venit în călătoria ta în lumea Model Context Protocol! Dacă te-ai întrebat vreodată cum comunică aplicațiile AI cu diferite instrumente și servicii, ești pe cale să descoperi soluția elegantă care transformă modul în care dezvoltatorii construiesc sisteme inteligente.
Gândește-te la MCP ca la un traducător universal pentru aplicațiile AI – la fel cum porturile USB îți permit să conectezi orice dispozitiv la calculator, MCP permite modelelor AI să se conecteze la orice instrument sau serviciu într-un mod standardizat. Fie că construiești primul tău chatbot sau lucrezi la fluxuri de lucru AI complexe, înțelegerea MCP îți va oferi puterea de a crea aplicații mai capabile și mai flexibile.
Acest curriculum este conceput cu răbdare și grijă pentru parcursul tău de învățare. Vom începe cu concepte simple pe care deja le înțelegi și vom construi treptat expertiza ta prin practică directă în limbajul de programare preferat. Fiecare pas include explicații clare, exemple practice și multă încurajare pe parcurs.
Până la finalul acestei călătorii, vei avea încrederea să construiești propriile servere MCP, să le integrezi cu platformele AI populare și să înțelegi cum această tehnologie remodelează viitorul dezvoltării AI. Să începem această aventură captivantă împreună!
Acest curriculum este aliniat cu Specificația MCP 2025-11-25 (ultima versiune stabilă). Specificația MCP folosește versiuni bazate pe dată (format YYYY-MM-DD) pentru a asigura o urmărire clară a versiunii protocolului.
Aceste resurse devin mai valoroase pe măsură ce înțelegerea ta crește, dar nu te simți presat să le parcurgi pe toate imediat. Începe cu ariile care te interesează cel mai mult!
- 📘 Documentație MCP – Acesta este resursa de referință pentru tutoriale pas cu pas și ghiduri pentru utilizatori. Documentația este scrisă având în vedere începătorii, oferind exemple clare pe care le poți urmări în ritmul tău.
- 📜 Specificația MCP – Gândește-te la aceasta ca la manualul tău complet de referință. Pe măsură ce parcurgi curriculum-ul, vei reveni aici pentru a căuta detalii specifice și pentru a explora funcții avansate.
- 📜 Versionarea specificației MCP – Aici vei găsi informații despre istoricul versiunilor protocolului și modul în care MCP folosește versiuni bazate pe dată (format YYYY-MM-DD).
- 🧑💻 Depozitul MCP pe GitHub – Aici găsești SDK-uri, instrumente și exemple de cod în multiple limbaje de programare. Este ca o comoară de exemple practice și componente gata de utilizare.
- 🌐 Comunitatea MCP – Alătură-te altor cursanți și dezvoltatori experimentați în discuții despre MCP. Este o comunitate primitoare unde întrebările sunt binevenite și cunoștințele sunt împărtășite liber.
La finalul acestui curriculum, te vei simți sigur pe tine și entuziasmat de noile tale abilități. Iată ce vei realiza:
• Înțelegerea fundamentelor MCP: Vei înțelege ce este Model Context Protocol și de ce revoluționează modul în care aplicațiile AI lucrează împreună, folosind analogii și exemple clare.
• Construirea primului tău server MCP: Vei crea un server MCP funcțional în limbajul tău preferat, începând cu exemple simple și dezvoltându-ți abilitățile pas cu pas.
• Conectarea modelelor AI la instrumente reale: Vei învăța cum să faci puntea între modelele AI și serviciile reale, oferind aplicațiilor tale capacități noi și puternice.
• Implementarea celor mai bune practici de securitate: Vei înțelege cum să păstrezi implementările MCP sigure, protejând atât aplicațiile, cât și utilizatorii tăi.
• Dezvoltare și lansare cu încredere: Vei ști cum să duci proiectele MCP de la dezvoltare la producție, cu strategii practice de implementare care funcționează în lumea reală.
• Alăturarea comunității MCP: Vei deveni parte dintr-o comunitate în creștere de dezvoltatori care modelează viitorul dezvoltării aplicațiilor AI.
Înainte de a intra în detaliile MCP, să ne asigurăm că te simți confortabil cu câteva concepte fundamentale. Nu-ți face griji dacă nu ești expert în aceste domenii – îți vom explica tot ce trebuie să știi pe parcurs!
Gândește-te la un protocol ca la regulile unei conversații. Când suni un prieten, știți amândoi să spuneți "salut" când răspundeți, să luați rândul la vorbit și să spuneți "la revedere" când ați terminat. Programele de calculator au nevoie de reguli similare pentru a comunica eficient.
MCP este un protocol – un set de reguli convenite care ajută modelele și aplicațiile AI să aibă "conversații" productive cu instrumente și servicii. La fel cum regulile unei conversații fac comunicarea între oameni mai fluidă, MCP face comunicarea între aplicațiile AI mult mai fiabilă și puternică.
Folosesti relații client-server zi de zi! Când folosești un browser web (clientul) pentru a vizita un site, te conectezi la un server web care îți trimite conținutul paginii. Browser-ul știe cum să ceară informații și serverul știe cum să răspundă.
În MCP, avem o relație similară: modelele AI acționează ca și clienți care solicită informații sau acțiuni, în timp ce serverele MCP furnizează aceste capabilități. Este ca și cum ai avea un asistent util (serverul) pe care AI-ul îl poate ruga să îndeplinească sarcini specifice.
Imaginează-ți dacă fiecare producător de mașini ar folosi pompe de gaz de formă diferită – ai avea nevoie de un adaptor diferit pentru fiecare mașină! Standardizarea înseamnă să cădem de acord asupra unor metode comune astfel încât lucrurile să funcționeze împreună fără probleme.
MCP oferă această standardizare pentru aplicațiile AI. În loc ca fiecare model AI să aibă cod personalizat pentru a lucra cu fiecare instrument, MCP creează o modalitate universală de comunicare. Asta înseamnă că dezvoltatorii pot construi instrumente o singură dată și acestea vor funcționa cu multe sisteme AI diferite.
Călătoria ta MCP este atent structurată pentru a-ți dezvolta încrederea și abilitățile progresiv. Fiecare fază introduce concepte noi în timp ce consolidează ceea ce ai învățat deja.
Aici începe aventura ta! Vom introduce conceptele MCP folosind analogii familiare și exemple simple. Vei înțelege ce este MCP, de ce există și cum se încadrează în lumea mai largă a dezvoltării AI.
• Modul 0 - Introducere în MCP: Vom începe explorând ce este MCP și de ce este atât de important pentru aplicațiile AI moderne. Vei vedea exemple reale de MCP în acțiune și vei înțelege cum rezolvă probleme comune pentru dezvoltatori.
• Modul 1 - Explicarea conceptelor de bază: Aici vei învăța elementele esențiale ale MCP. Vom folosi multe analogii și exemple vizuale pentru a face aceste concepte naturale și ușor de înțeles.
• Modul 2 - Securitatea în MCP: Securitatea poate părea intimidantă, dar îți vom arăta cum MCP include funcții de siguranță integrate și îți vom explica cele mai bune practici care protejează aplicațiile de la început.
Acum începe adevărata distracție! Vei avea experiență practică construind servere și clienți MCP reali. Nu-ți face griji - vom începe simplu și te vom ghida la fiecare pas.
Acest modul include mai multe ghiduri practice care îți permit să exersezi în limbajul de programare preferat. Vei crea primul tău server, vei construi un client care să se conecteze la acesta și chiar vei integra cu unelte populare de dezvoltare precum VS Code.
Fiecare ghid include exemple complete de cod, sfaturi pentru depanare și explicații despre de ce facem anumite alegeri de design. La finalul acestei etape, vei avea implementări MCP funcționale de care să fii mândru!
Odată ce ai stăpânit elementele de bază, ești gata să explorezi funcționalități MCP mai sofisticate. Vom acoperi strategii practice de implementare, tehnici de depanare și subiecte avansate precum integrarea AI multimodală.
De asemenea, vei învăța cum să scalezi implementările MCP pentru utilizare în producție și cum să integrezi cu platforme cloud precum Azure. Aceste module te pregătesc să construiești soluții MCP care să facă față cerințelor din lumea reală.
Faza finală se concentrează pe aderarea la comunitatea MCP și specializarea în domeniile care te interesează cel mai mult. Vei învăța cum să contribui la proiecte MCP open-source, să implementezi modele avansate de autentificare și să construiești soluții complete integrate cu baze de date.
Modulul 11 merită o mențiune specială - este un parcurs complet de învățare hands-on cu 13 laboratoare care te învață să construiești servere MCP gata de producție cu integrare PostgreSQL. Este ca un proiect final care reunește tot ce ai învățat!
| Modul | Subiect | Descriere | Link |
|---|---|---|---|
| Module 0-3: Fundamente | |||
| 00 | Introducere în MCP | Prezentare generală a protocolului Model Context și semnificația sa în fluxurile AI | Citește mai mult |
| 01 | Concepte de bază explicate | Explorare aprofundată a conceptelor fundamentale MCP | Citește mai mult |
| 02 | Securitatea în MCP | Amenințări de securitate și bune practici | Citește mai mult |
| 03 | Început cu MCP | Configurarea mediului, servere/cliens simple, integrare | Citește mai mult |
| Modul 3: Construirea primului tău server & client | |||
| 3.1 | Primul server | Creează primul tău server MCP | Ghid |
| 3.2 | Primul client | Dezvoltă un client MCP de bază | Ghid |
| 3.3 | Client cu LLM | Integrează modele lingvistice mari | Ghid |
| 3.4 | Integrare VS Code | Consuma servere MCP în VS Code | Ghid |
| 3.5 | Server stdio | Creează servere folosind transport stdio | Ghid |
| 3.6 | Streaming HTTP | Implementează streaming HTTP în MCP | Ghid |
| 3.7 | AI Toolkit | Folosește AI Toolkit cu MCP | Ghid |
| 3.8 | Testare | Testează implementarea serverului MCP | Ghid |
| 3.9 | Implementare | Publică servere MCP în producție | Ghid |
| 3.10 | Utilizare avansată server | Folosește servere avansate pentru caracteristici avansate și arhitectură îmbunătățită | Ghid |
| 3.11 | Autentificare simplă | Un capitol care îți arată autentificarea de la început și RBAC | Ghid |
| 3.12 | Gazde MCP | Configurează Claude Desktop, Cursor, Cline și alte gazde MCP | Ghid |
| 3.13 | MCP Inspector | Depanează și testează servere MCP cu instrumentul Inspector | Ghid |
| 3.14 | Sampling | Folosește sampling pentru colaborare cu clientul | Ghid |
| 3.15 | Aplicații MCP | Construiește aplicații MCP | Ghid |
| Module 4-5: Practic & Avansat | |||
| 04 | Implementare practică | SDK-uri, depanare, testare, șabloane reutilizabile | Citește mai mult |
| 4.1 | Paginare | Gestionează seturi mari de rezultate cu paginare pe cursor | Ghid |
| 05 | Subiecte avansate în MCP | AI multimodal, scalare, utilizare enterprise | Citește mai mult |
| 5.1 | Integrare Azure | Integrare MCP cu Azure | Ghid |
| 5.2 | Multimodalitate | Lucrul cu multiple modalități | Ghid |
| 5.3 | Demo OAuth2 | Implementează autentificare OAuth2 | Ghid |
| 5.4 | Contexturi root | Înțelege și implementează contexturi root | Ghid |
| 5.5 | Rutare | Strategii de rutare MCP | Ghid |
| 5.6 | Sampling | Tehnici de sampling în MCP | Ghid |
| 5.7 | Scalare | Scalează implementările MCP | Ghid |
| 5.8 | Securitate | Considerații avansate de securitate | Ghid |
| 5.9 | Căutare web | Implementează capabilități de căutare web | Ghid |
| 5.10 | Streaming realtime | Construiește funcționalitate de streaming în timp real | Ghid |
| 5.11 | Căutare realtime | Implementează căutare în timp real | Ghid |
| 5.12 | Autentificare Entra ID | Autentificare cu Microsoft Entra ID | Ghid |
| 5.13 | Integrare Foundry | Integrare cu Azure AI Foundry | Ghid |
| 5.14 | Ingineria contextului | Tehnici pentru ingineria contextului eficient | Ghid |
| 5.15 | Transport personalizat MCP | Implementări de transport personalizate | Ghid |
| 5.16 | Funcționalități protocol | Notificări de progres, anulare, șabloane resurse | Ghid |
| 5.17 | Raționament multi-agent adversarial | Doi agenți dezbat părți opuse folosind instrumente MCP comune, evaluați de un agent judecător | Ghid |
| Module 6-10: Comunitate & Best Practices | |||
| 06 | Contribuții comunitare | Cum să contribui la ecosistemul MCP | Ghid |
| 07 | Lecții din adopția timpurie | Povești de implementare în lumea reală | Ghid |
| 08 | Best Practices pentru MCP | Performanță, toleranță la defecte, reziliență | Ghid |
| 09 | Studii de caz MCP | Exemple practice de implementare | Ghid |
| 10 | Workshop hands-on | Construirea unui server MCP cu AI Toolkit | Laborator |
| Modul 11: Laborator hands-on server MCP | |||
| 11 | Integrare baze de date server MCP | Parcurs complet cu 13 laboratoare pentru integrarea PostgreSQL | Laboratoare |
| 11.1 | Introducere | Prezentare generală MCP cu integrare baze de date și cazul de utilizare retail analytics | Laborator 00 |
| 11.2 | Arhitectură de bază | Înțelegerea arhitecturii serverului MCP, straturile bazei de date și modelele de securitate | Laborator 01 |
| 11.3 | Securitate & Multi-tenancy | Securitatea la nivel de rând, autentificare și acces multi-tenant la date | Laborator 02 |
| 11.4 | Configurare mediu | Configurarea mediului de dezvoltare, Docker, resurse Azure | Laborator 03 |
| 11.5 | Design baze de date | Configurare PostgreSQL, design schema retail și date exemplu | Laborator 04 |
| 11.6 | Implementare server MCP | Construirea serverului FastMCP cu integrare baze de date | Laborator 05 |
| 11.7 | Dezvoltare unelte | Crearea uneltelor pentru interogare baze de date și introspecția schema | Laborator 06 |
| 11.8 | Căutare semantică | Implementarea embeddings vectoriale cu Azure OpenAI și pgvector | Laborator 07 |
| 11.9 | Testare & depanare | Strategii de testare, unelte de depanare și metode de validare | Laborator 08 |
| 11.10 | Integrare VS Code | Configurarea integrării MCP în VS Code și folosirea AI Chat | Laborator 09 |
| 11.11 | Strategii de implementare | Implementare Docker, Azure Container Apps și considerații de scalare | Laborator 10 |
| 11.12 | Monitorizare | Application Insights, logging, monitorizarea performanței | Laborator 11 |
| 11.13 | Best Practices | Optimizarea performanței, întărirea securității și sfaturi pentru producție | Laborator 12 |
Una dintre cele mai captivante părți ale învățării MCP este să vezi cum abilitățile tale de codare se dezvoltă progresiv. Am conceput exemplele noastre de cod să înceapă simplu și să devină mai sofisticate pe măsură ce înțelegerea ta se adâncește. Iată cum introducem conceptele - cu cod ușor de înțeles, dar care demonstrează principii reale MCP, vei înțelege nu doar ce face acest cod, ci de ce este structurat astfel și cum se potrivește în aplicații MCP mai mari.
| Limbaj | Descriere | Link |
|---|---|---|
| C# | Exemplu server MCP | Vezi cod |
| Java | Calculator MCP | Vezi cod |
| JavaScript | Demo MCP | Vezi cod |
| Python | Server MCP | Vezi cod |
| TypeScript | Exemplu MCP | Vezi cod |
| Rust | Exemplu MCP | Vezi cod |
| Limbaj | Descriere | Link |
|---|---|---|
| C# | Exemplu avansat | Vezi cod |
| Java cu Spring | Exemplu aplicație container | Vezi cod |
| JavaScript | Exemplu avansat | Vezi cod |
| Python | Implementare complexă | Vezi cod |
| TypeScript | Exemplu Container | Vezi Cod |
Pentru a beneficia la maximum de acest curriculum, ar trebui să ai:
-
Cunoștințe de bază de programare în cel puțin unul dintre următoarele limbaje: C#, Java, JavaScript, Python sau TypeScript
-
Înțelegerea modelului client-server și a API-urilor
-
Familiaritate cu conceptele REST și HTTP
-
(Opțional) Cunoștințe de bază despre AI/ML
-
Participarea la discuțiile comunității noastre pentru suport
Acest depozit include mai multe resurse pentru a te ajuta să navighezi și să înveți eficient:
Un Ghid de studiu cuprinzător este disponibil pentru a te ajuta să navighezi eficient prin acest depozit. Această hartă vizuală a curriculumului arată cum sunt conectate toate subiectele și oferă îndrumări despre cum să folosești eficient proiectele exemplu. Este utilă mai ales dacă înveți vizual și îți place să vezi imaginea de ansamblu.
Ghidul include:
- O hartă vizuală a curriculumului care prezintă toate subiectele acoperite
- Defalcarea detaliată a fiecărei secțiuni din depozit
- Îndrumări despre cum să folosești proiectele exemplu
- Căi recomandate de învățare pentru niveluri diferite de experiență
- Resurse suplimentare pentru a completa călătoria ta de învățare
Păstrăm un Changelog detaliat care urmărește toate actualizările semnificative ale materialelor de curriculum, astfel încât să fii la curent cu cele mai recente îmbunătățiri și completări.
- Adăugări de conținut nou
- Schimbări structurale
- Îmbunătățiri de caracteristici
- Actualizări de documentație
Fiecare lecție din acest ghid include:
- Explicații clare ale conceptelor MCP
- Exemple de cod live în mai multe limbaje
- Exerciții pentru a crea aplicații reale MCP
- Resurse suplimentare pentru cursanți avansați
Hai să explorăm Model Context Protocol (MCP), un cadru inovator creat pentru a standardiza interacțiunile dintre modelele AI și aplicațiile client. Prin această sesiune prietenoasă pentru începători, îți vom prezenta MCP și te vom ghida să-ți creezi primul server MCP.
JavaScript: https://aka.ms/letslearnmcp-javascript
Felicitări! Tocmai ai făcut primul pas într-o călătorie interesantă ce-ți va extinde abilitățile de programare și te va conecta la cele mai avansate tehnologii AI.
Citind această introducere, ai început deja să-ți construiești baza de cunoștințe MCP. Înțelegi ce este MCP, de ce este important și cum te va susține acest curriculum în procesul tău de învățare. Aceasta este o realizare semnificativă și începutul expertizei tale în această tehnologie importantă.
Pe măsură ce parcurgi modulele, amintește-ți că fiecare expert a fost cândva începător. Conceptele care acum ți se par complexe vor deveni a doua ta natură pe măsură ce le exersezi și aplici. Fiecare pas mic clădește capacități puternice care te vor servi pe tot parcursul carierei tale în dezvoltare.
Te alături unei comunități de cursanți și experți pasionați de MCP, dornici să ajute pe alții să reușească. Indiferent dacă întâmpini o provocare de codare sau ești entuziasmat să împărtășești o descoperire, comunitatea este aici pentru a susține călătoria ta.
Dacă te blochezi sau ai întrebări despre construirea aplicațiilor AI. Alătură-te discuțiilor cu alți cursanți și dezvoltatori experimentați despre MCP. Este o comunitate suportivă unde întrebările sunt binevenite și cunoștințele sunt împărtășite liber.
Dacă ai feedback despre produs sau întâmpini erori în timpul dezvoltării, vizitează:
Aventura ta MCP începe acum! Începe cu Modulul 0 pentru a te cufunda în primele tale experiențe practice MCP sau explorează proiectele exemple pentru a vedea ce vei construi. Amintește-ți - fiecare expert a început exact de unde ești tu acum, iar cu răbdare și practică, vei fi uimit de ceea ce poți realiza.
Bine ai venit în lumea dezvoltării cu Model Context Protocol. Hai să construim ceva uimitor împreună!
Acest curriculum devine mai puternic prin contribuțiile cursanților ca tine! Fie că remediezi o greșeală de scriere, sugerezi o explicație mai clară sau adaugi un exemplu nou, contribuțiile tale ajută alți începători să reușească.
Mulțumiri profesionistului valoros Microsoft Shivam Goyal pentru contribuțiile sale cu exemple de cod.
Procesul de contribuție este conceput să fie primitor și suportiv. Majoritatea contribuțiilor necesită un Acord de Licență al Contribuitorului (CLA), dar instrumentele automate te vor ghida ușor prin proces.
Întregul acest curriculum este disponibil sub licența MIT LICENSE, ceea ce înseamnă că îl poți folosi, modifica și distribui liber. Acest lucru susține misiunea noastră de a face cunoștințele MCP accesibile dezvoltatorilor oriunde.
Acest proiect primește contribuții și sugestii cu plăcere. Majoritatea contribuțiilor necesită să accepți un Acord de Licență al Contribuitorului (CLA) prin care declari că ai dreptul și într-adevăr ne acorzi drepturile de a folosi contribuția ta. Pentru detalii, vizitează https://cla.opensource.microsoft.com.
Când trimiți o cerere de pull, un bot CLA va determina automat dacă trebuie să furnizezi un CLA și va decora PR-ul corespunzător (de ex., verificare status, comentariu). Urmează pur și simplu instrucțiunile date de bot. Va trebui să faci asta o singură dată pentru toate repo-urile care folosesc CLA-ul nostru.
Acest proiect a adoptat Codul de conduită Open Source Microsoft. Pentru mai multe informații, vezi Întrebări frecvente despre Codul de conduită sau contactează opencode@microsoft.com pentru orice întrebări sau comentarii suplimentare.
Gata să începi călătoria MCP? Începe cu Modulul 00 - Introducere în MCP și fă-ți primii pași în lumea dezvoltării Model Context Protocol!
Echipa noastră produce și alte cursuri! Vezi:
-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA){kind=icon}
-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC){kind=icon}
-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9){kind=icon}
Declinare a responsabilității:
Acest document a fost tradus folosind serviciul de traducere AI Co-op Translator. Deși ne străduim pentru acuratețe, vă rugăm să rețineți că traducerile automate pot conține erori sau inexactități. Documentul original în limba sa nativă trebuie considerat sursa autoritară. Pentru informații critice, se recomandă traducerea profesională realizată de un specialist uman. Nu ne asumăm nicio răspundere pentru eventualele neînțelegeri sau interpretări greșite rezultate din utilizarea acestei traduceri.