Urmați acești pași pentru a începe să utilizați aceste resurse:
- Forkați Repozitoriul: Click
- Clonați Repozitoriul:
git clone https://github.com/microsoft/mcp-for-beginners.git - Alăturați-vă Discordului Azure AI Foundry și întâlniți experți și alți dezvoltatori
🌐 Suport Multi-Limbă
Suportat prin GitHub Action (Automat & Mereu Actualizat)
Arabă | Bengaleză | Bulgară | Birmană (Myanmar) | Chineză (Simplificată) | Chineză (Tradițională, Hong Kong) | Chineză (Tradițională, Macau) | Chineză (Tradițională, Taiwan) | Croată | Cehă | Daneză | Olandeză | Finlandeză | Franceză | Germană | Greacă | Ebraică | Hindi | Maghiară | Indoneziană | Italiană | Japoneză | Coreeană | Malayeză | Marathi | Nepaleză | Norvegiană | Persană (Farsi) | Poloneză | Portugheză (Brazilia) | Portugheză (Portugalia) | Punjabi (Gurmukhi) | Română | Rusă | Sârbă (Chirilică) | Slovacă | Slovenă | Spaniolă | Swahili | Suedeză | Tagalog (Filipineză) | Thailandeză | Turcă | Ucraineană | Urdu | Vietnameză
🚀 Curriculum Model Context Protocol (MCP) pentru Începători
Învățați MCP cu Exemple Practice de Cod în C#, Java, JavaScript, Rust, Python și TypeScript
🧠 Prezentare Generală a Curriculumului Model Context Protocol
Model Context Protocol (MCP) este un cadru de ultimă generație conceput pentru a standardiza interacțiunile dintre modelele AI și aplicațiile client. Acest curriculum open-source oferă o cale de învățare structurată, completată cu exemple practice de cod și cazuri de utilizare reale, în limbaje de programare populare precum C#, Java, JavaScript, TypeScript și Python.
Indiferent dacă sunteți dezvoltator AI, arhitect de sisteme sau inginer software, acest ghid este resursa dvs. completă pentru a stăpâni fundamentele MCP și strategiile de implementare.
🔗 Resurse Oficiale MCP
- 📘 Documentația MCP – Tutoriale detaliate și ghiduri pentru utilizatori
- 📜 Specificația MCP – Arhitectura protocolului și referințe tehnice
- 📜 Specificația Originală MCP – Referințe tehnice vechi (pot conține detalii suplimentare)
- 🧑💻 Repozitoriul GitHub MCP – SDK-uri open-source, instrumente și exemple de cod
- 🌐 Comunitatea MCP – Alăturați-vă discuțiilor și contribuiți la comunitate
🧭 Prezentare Generală a Curriculumului MCP
📚 Structura Completă a Curriculumului
| Modul | Subiect | Descriere | Link |
|---|---|---|---|
| Modulele 1-3: Fundamente | |||
| 00 | Introducere în MCP | Prezentare generală a Model Context Protocol și semnificația sa în fluxurile AI | Citiți mai mult |
| 01 | Explicarea Conceptelor de Bază | Explorare detaliată a conceptelor de bază MCP | Citiți mai mult |
| 02 | Securitate în MCP | Amenințări de securitate și cele mai bune practici | Citiți mai mult |
| 03 | Începerea cu MCP | Configurarea mediului, servere/clienți de bază, integrare | Citiți mai mult |
| Modulul 3: Construirea Primului Server și Client | |||
| 3.1 | Primul Server | Creați primul dvs. server MCP | Ghid |
| 3.2 | Primul Client | Dezvoltați un client MCP de bază | Ghid |
| 3.3 | Client cu LLM | Integrați modele de limbaj mare | Ghid |
| 3.4 | Integrare VS Code | Consumați servere MCP în VS Code | Ghid |
| 3.5 | Server stdio | Creați servere utilizând transportul stdio | Ghid |
| 3.6 | Streaming HTTP | Implementați streaming HTTP în MCP | Ghid |
| 3.7 | Toolkit AI | Utilizați Toolkit AI cu MCP | Ghid |
| 3.8 | Testare | Testați implementarea serverului MCP | Ghid |
| 3.9 | Implementare | Implementați servere MCP în producție | Ghid |
| 3.10 | Utilizare avansată a serverului | Utilizați servere avansate pentru funcționalități avansate și arhitectură îmbunătățită | Ghid |
| 3.11 | Autentificare simplă | Un capitol care vă arată autentificarea de la început și RBAC | Ghid |
| Modulele 4-5: Practic & Avansat | |||
| 04 | Implementare Practică | SDK-uri, depanare, testare, șabloane de prompt reutilizabile | Citiți mai mult |
| 05 | Subiecte Avansate în MCP | AI multi-modal, scalare, utilizare în întreprinderi | Citiți mai mult |
| 5.1 | Integrare Azure | Integrarea MCP cu Azure | Ghid |
| 5.2 | Multi-modalitate | Lucrul cu multiple modalități | Ghid |
| 5.3 | Demo OAuth2 | Implementați autentificarea OAuth2 | Ghid |
| 5.4 | Contexturi Rădăcină | Înțelegeți și implementați contexturi rădăcină | Ghid |
| 5.5 | Rutare | Strategii de rutare MCP | Ghid |
| 5.6 | Eșantionare | Tehnici de eșantionare în MCP | Ghid |
| 5.7 | Scalare | Scalați implementările MCP | Ghid |
| 5.8 | Securitate | Considerații avansate de securitate | Ghid |
| 5.9 | Căutare Web | Implementați capacități de căutare web | Ghid |
| 5.10 | Streaming în Timp Real | Construiți funcționalități de streaming în timp real | Ghid |
| 5.11 | Căutare în Timp Real | Implementați căutare în timp real | Ghid |
| 5.12 | Autentificare Entra ID | Autentificare cu Microsoft Entra ID | Ghid |
| 5.13 | Integrare Foundry | Integrați cu Azure AI Foundry | Ghid |
| 5.14 | Inginerie Contextuală | Tehnici pentru inginerie contextuală eficientă | Ghid |
| 5.15 | Transport Personalizat MCP | Implementări de Transport Personalizat | Ghid |
| Modulele 6-10: Comunitate & Cele Mai Bune Practici | |||
| 06 | Contribuții Comunitare | Cum să contribuiți la ecosistemul MCP | Ghid |
| 07 | Perspective din Adopția Timpurie | Povești de implementare din lumea reală | Ghid |
| 08 | Cele Mai Bune Practici pentru MCP | Performanță, toleranță la erori, reziliență | Ghid |
| 09 | Studii de Caz MCP | Exemple practice de implementare | Ghid |
| 10 | Atelier Practic | Construirea unui Server MCP cu Toolkit AI | Laborator |
| Modulul 11: Laborator Practic Server MCP | |||
| 11 | Integrare Server MCP cu Bază de Date | Cale de învățare practică cu 13 laboratoare pentru integrarea PostgreSQL | Laboratoare |
| 11.1 | Introducere | Prezentare generală a MCP cu integrare bază de date și caz de utilizare analitică retail | Laborator 00 |
| 11.2 | Arhitectura de Bază | Înțelegerea arhitecturii serverului MCP, straturilor de baze de date și modelelor de securitate | Lab 01 |
| 11.3 | Securitate & Multi-Tenancy | Securitate la nivel de rând, autentificare și acces la date multi-tenant | Lab 02 |
| 11.4 | Configurarea Mediului | Configurarea mediului de dezvoltare, Docker, resurse Azure | Lab 03 |
| 11.5 | Designul Bazei de Date | Configurarea PostgreSQL, designul schemei de retail și date de exemplu | Lab 04 |
| 11.6 | Implementarea Serverului MCP | Construirea serverului FastMCP cu integrarea bazei de date | Lab 05 |
| 11.7 | Dezvoltarea Uneltelor | Crearea uneltelor de interogare a bazei de date și introspecția schemei | Lab 06 |
| 11.8 | Căutare Semantică | Implementarea vectorilor de încorporare cu Azure OpenAI și pgvector | Lab 07 |
| 11.9 | Testare & Depanare | Strategii de testare, unelte de depanare și metode de validare | Lab 08 |
| 11.10 | Integrarea cu VS Code | Configurarea integrării MCP în VS Code și utilizarea AI Chat | Lab 09 |
| 11.11 | Strategii de Implementare | Implementare cu Docker, Azure Container Apps și considerații de scalare | Lab 10 |
| 11.12 | Monitorizare | Application Insights, jurnalizare, monitorizarea performanței | Lab 11 |
| 11.13 | Cele Mai Bune Practici | Optimizarea performanței, consolidarea securității și sfaturi pentru producție | Lab 12 |
💻 Proiecte de Cod Exemplu
Exemple de Calculatoare MCP de Bază
| Limbaj | Descriere | Link |
|---|---|---|
| C# | Exemplu de Server MCP | Vizualizează Codul |
| Java | Calculator MCP | Vizualizează Codul |
| JavaScript | Demo MCP | Vizualizează Codul |
| Python | Server MCP | Vizualizează Codul |
| TypeScript | Exemplu MCP | Vizualizează Codul |
| Rust | Exemplu MCP | Vizualizează Codul |
Implementări Avansate MCP
| Limbaj | Descriere | Link |
|---|---|---|
| C# | Exemplu Avansat | Vizualizează Codul |
| Java cu Spring | Exemplu de Aplicație Container | Vizualizează Codul |
| JavaScript | Exemplu Avansat | Vizualizează Codul |
| Python | Implementare Complexă | Vizualizează Codul |
| TypeScript | Exemplu de Container | Vizualizează Codul |
🎯 Cerințe Prealabile pentru Învățarea MCP
Pentru a beneficia la maximum de acest curriculum, ar trebui să aveți:
Cunoștințe de bază în 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) Fundamente în concepte AI/ML
Participarea la discuțiile comunității pentru suport
📚 Ghid de Studiu & Resurse
Acest depozit include mai multe resurse pentru a vă ajuta să navigați și să învățați eficient:
Ghid de Studiu
Un Ghid de Studiu cuprinzător este disponibil pentru a vă ajuta să navigați eficient în acest depozit. Ghidul include:
- O hartă vizuală a curriculumului care arată toate subiectele acoperite
- Detalii despre fiecare secțiune a depozitului
- Indicații despre cum să utilizați proiectele de exemplu
- Căi de învățare recomandate pentru diferite niveluri de competență
- Resurse suplimentare pentru a completa procesul de învățare
Jurnal de Modificări
Menținem un Jurnal de Modificări detaliat care urmărește toate actualizările semnificative ale materialelor curriculumului, inclusiv:
- Adăugiri de conținut nou
- Modificări structurale
- Îmbunătățiri ale funcționalităților
- Actualizări ale documentației
🛠️ Cum să Utilizați Eficient Acest Curriculum
Fiecare lecție din acest ghid include:
- Explicații clare ale conceptelor MCP
- Exemple de cod live în mai multe limbaje
- Exerciții pentru construirea aplicațiilor MCP reale
- Resurse suplimentare pentru cursanții avansați
Evenimente
MCP Dev Days Iulie 2025
➡️Urmărește la Cerere - MCP Dev Days
Pregătește-te pentru două zile de informații tehnice aprofundate, conexiuni comunitare și învățare practică la MCP Dev Days, un eveniment virtual dedicat Protocolului Model Context (MCP) — standardul emergent care conectează modelele AI și uneltele pe care se bazează. Poți urmări MCP Dev Days înregistrându-te pe pagina noastră de eveniment: https://aka.ms/mcpdevdays.
Ziua 1: Productivitate MCP, Unelte de Dezvoltare & Comunitate:
Este dedicată dezvoltatorilor, pentru a utiliza MCP în fluxul lor de lucru și pentru a celebra comunitatea MCP. Vom fi alături de membri ai comunității și parteneri precum Arcade, Block, Okta și Neon pentru a vedea cum colaborează cu Microsoft pentru a modela un ecosistem MCP deschis și extensibil.
Demonstrații reale în VS Code, Visual Studio, GitHub Copilot și unelte populare ale comunității
Fluxuri de lucru practice, orientate pe context
Sesiuni și perspective conduse de comunitate
Indiferent dacă abia începi cu MCP sau construiești deja cu el, Ziua 1 va oferi inspirație și sfaturi practice.
Ziua 2: Construiește Servere MCP cu Încredere
Este dedicată constructorilor MCP. Vom aprofunda strategiile de implementare și cele mai bune practici pentru crearea serverelor MCP și integrarea MCP în fluxurile de lucru AI.
Subiecte incluse:
- Construirea serverelor MCP și integrarea lor în experiențele agenților
- Dezvoltare bazată pe prompturi
- Cele mai bune practici de securitate
- Utilizarea blocurilor de construcție precum Functions, ACA și API Management
- Alinierea registrului și unelte (1P + 3P)
Dacă ești dezvoltator, constructor de unelte sau strateg de produse AI, această zi este plină de informații de care ai nevoie pentru a construi soluții MCP scalabile, sigure și pregătite pentru viitor.
MCP Boot Camp August 2025
Învață în sesiuni video intensive cum să creezi servere MCP, să integrezi cu VS Code și să implementezi profesional pe Azure, bazat pe conținutul curriculumului MCP pentru Începători. Pleacă cu abilități practice într-o tehnologie pe care companii majore o folosesc deja.
➡️Urmărește la Cerere MCP Bootcamp | Engleză
➡️Urmărește la Cerere MCP Bootcamp | Brazilia
➡️Urmărește la Cerere MCP Bootcamp | Spaniolă
Să Învățăm MCP cu C# - Seria de Tutoriale
Să învățăm despre Protocolul Model Context (MCP), un cadru de ultimă generație conceput pentru a standardiza interacțiunile dintre modelele AI și aplicațiile client. Prin această sesiune prietenoasă pentru începători, te vom introduce în MCP și te vom ghida în crearea primului tău server MCP.
C#: https://aka.ms/letslearnmcp-csharp
Java: https://aka.ms/letslearnmcp-java
JavaScript: https://aka.ms/letslearnmcp-javascript
Python: https://aka.ms/letslearnmcp-python
🌟 Mulțumiri Comunității
Mulțumiri Microsoft Valued Professional Shivam Goyal pentru contribuirea cu exemple importante de cod.
📜 Informații despre Licență
Acest conținut este licențiat sub Licența MIT. Pentru termeni și condiții, vezi LICENSE.
🤝 Ghid pentru Contribuții
Acest proiect acceptă contribuții și sugestii. Majoritatea contribuțiilor necesită să fiți de acord cu un Acord de Licență pentru Contribuitor (CLA) care declară că aveți dreptul de a, și chiar acordați, drepturile de a utiliza contribuția dvs. Pentru detalii, vizitați https://cla.opensource.microsoft.com.
Când trimiteți un pull request, un bot CLA va determina automat dacă trebuie să furnizați un CLA și va decora PR-ul corespunzător (de exemplu, verificare de stare, comentariu). Urmați pur și simplu instrucțiunile furnizate de bot. Va trebui să faceți acest lucru o singură dată pentru toate depozitele care utilizează CLA-ul nostru.
Acest proiect a adoptat Codul de Conduită Open Source Microsoft. Pentru mai multe informații, consultați FAQ-ul Codului de Conduită sau contactați opencode@microsoft.com pentru întrebări sau comentarii suplimentare.
📂 Structura Depozitului
Depozitul este organizat astfel:
- Curriculum de Bază (00-11): Conținutul principal organizat în unsprezece module secvențiale, inclusiv laboratoare complete de integrare a bazei de date
- 11-MCPServerHandsOnLabs/: Cale completă de învățare cu 13 laboratoare pentru construirea serverelor MCP pregătite pentru producție cu integrare PostgreSQL
- images/: Diagrame și ilustrații utilizate pe parcursul curriculumului
- translations/: Suport multilingvistic cu traduceri automate
- translated_images/: Versiuni localizate ale diagramelor și ilustrațiilor
- study_guide.md: Ghid cuprinzător pentru navigarea în depozit
- changelog.md: Înregistrare a tuturor modificărilor semnificative ale materialelor curriculumului
- mcp.json: Fișier de configurare pentru specificația MCP
- CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Documente de guvernanță ale proiectului
🎒 Alte Cursuri
Echipa noastră produce alte cursuri! Verifică:
- NOU Edge AI Pentru Începători
- AI Agenți Pentru Începători
- Generative AI pentru Începători folosind .NET
- Generative AI pentru Începători folosind JavaScript
- Generative AI pentru Începători
- Generative AI pentru Începători folosind Java
- ML pentru Începători
- Data Science pentru Începători
- AI pentru Începători
- Cybersecurity pentru Începători
- Web Dev pentru Începători
- IoT pentru Începători
- Dezvoltare XR pentru Începători
- Stăpânirea GitHub Copilot pentru Programare AI în Pereche
- Stăpânirea GitHub Copilot pentru Dezvoltatori C#/.NET
- Alege-ți propria aventură Copilot
™️ Notificare privind mărcile comerciale
Acest proiect poate conține mărci comerciale sau logo-uri pentru proiecte, produse sau servicii. Utilizarea autorizată a mărcilor comerciale sau logo-urilor Microsoft este supusă și trebuie să respecte Directiva Microsoft privind mărcile comerciale și brandurile. Utilizarea mărcilor comerciale sau logo-urilor Microsoft în versiuni modificate ale acestui proiect nu trebuie să provoace confuzie sau să implice sponsorizarea de către Microsoft. Orice utilizare a mărcilor comerciale sau logo-urilor terților este supusă politicilor acelor terți.
Obținerea ajutorului
Dacă întâmpinați dificultăți sau aveți întrebări despre construirea aplicațiilor AI, alăturați-vă:
Dacă aveți feedback despre produs sau întâmpinați erori în timpul construirii, vizitați:
Declinare de responsabilitate:
Acest document a fost tradus folosind serviciul de traducere AI Co-op Translator. Deși ne străduim să asigurăm acuratețea, vă rugăm să fiți conștienți că traducerile automate pot conține erori sau inexactități. Documentul original în limba sa natală ar trebui considerat sursa autoritară. Pentru informații critice, se recomandă traducerea profesională realizată de un specialist uman. Nu ne asumăm responsabilitatea pentru eventualele neînțelegeri sau interpretări greșite care pot apărea din utilizarea acestei traduceri.