Skip to content

Latest commit

 

History

History
263 lines (193 loc) · 19.8 KB

File metadata and controls

263 lines (193 loc) · 19.8 KB

MCP-for-beginners

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Azure AI Foundry Discord

Urmează acești pași pentru a începe să folosești aceste resurse:

  1. Fă fork la Repository: Apasă GitHub forks
  2. Clonează Repository-ul: git clone https://github.com/microsoft/mcp-for-beginners.git
  3. Alătură-te Discord-ului Azure AI Foundry și întâlnește experți și alți dezvoltatori

🌐 Suport Multi-Limbaj

Suportat prin GitHub Action (Automatizat & Întotdeauna Actualizat)

Franceză | Spaniolă | Germană | Rusă | Arabă | Persană (Farsi) | Urdu | Chineză (Simplificată) | Chineză (Tradițională, Macau) | Chineză (Tradițională, Hong Kong) | Chineză (Tradițională, Taiwan) | Japoneză | Coreeană | Hindi | Bengaleză | Marathi | Nepaleză | Punjabi (Gurmukhi) | Portugheză (Portugalia) | Portugheză (Brazilia) | Italiană | Poloneză | Turcă | Greacă | Thailandeză | Suedeză | Daneză | Norvegiană | Finlandeză | Olandeză | Ebraică | Vietnameză | Indoneziană | Malay | Tagalog (Filipineză) | Swahili | Maghiară | Cehă | Slovacă | Română | Bulgară | Sârbă (Chirilică) | Croată | Slovenă | Ucraineană | Burmese (Myanmar)

🚀 Curriculum Model Context Protocol (MCP) pentru Începători

Învață MCP cu exemple practice de cod în C#, Java, JavaScript, Python și TypeScript

🧠 Prezentare generală a curriculumului Model Context Protocol

Model Context Protocol (MCP) este un cadru de ultimă generație creat pentru a standardiza interacțiunile dintre modelele AI și aplicațiile client. Acest curriculum open-source oferă un parcurs de învățare structurat, completat cu exemple practice de cod și cazuri de utilizare din lumea reală, în limbaje de programare populare precum C#, Java, JavaScript, TypeScript și Python.

Indiferent dacă ești dezvoltator AI, arhitect de sisteme sau inginer software, acest ghid este resursa ta completă pentru a stăpâni fundamentele MCP și strategiile de implementare.

🔗 Resurse oficiale MCP

Alătură-te la MCP Dev Days 29-30 iulie 2025

Pregătește-te pentru două zile pline de informații tehnice aprofundate, conexiuni în comunitate și învățare practică la MCP Dev Days, un eveniment virtual dedicat Model Context Protocol (MCP) — standardul emergent care leagă modelele AI de uneltele pe care le folosesc.

➡️ Înregistrează-te pentru MCP Dev Days

Poți urmări MCP Dev Days în direct după ce te înregistrezi pe pagina evenimentului: https://aka.ms/mcpdevdays. De acolo, vei putea urmări live pe YouTube sau Twitch. Toate materialele vor fi înregistrate și disponibile ulterior pe canalul Microsoft Developer de pe YouTube. Codul sursă pentru demonstrații va fi disponibil și pe GitHub.

Detalii eveniment

  • Date: 29 iulie (Ziua 1) & 30 iulie (Ziua 2)
  • Ora: 9:00 AM PST zilnic
  • Unde: Online – participă de oriunde!

Ziua 1: Productivitate MCP, DevTools și Comunitate

Este dedicată echipării dezvoltatorilor să folosească MCP în fluxul lor de lucru și celebrării comunității MCP. Vom avea alături membri ai comunității și parteneri precum Arcade, Block, Okta și Neon pentru a vedea cum colaborează cu Microsoft pentru a crea un ecosistem MCP deschis și extensibil. Demonstrații reale în VS Code, Visual Studio, GitHub Copilot și unelte populare din comunitate
Fluxuri de lucru practice, orientate pe context
Sesiuni și perspective conduse de comunitate
Indiferent dacă abia începi cu MCP sau deja construiești cu el, Ziua 1 va oferi inspirație și recomandări practice.

Ziua 2: Construiește servere MCP cu încredere

Este pentru dezvoltatorii MCP. Vom aprofunda strategiile de implementare și cele mai bune practici pentru crearea serverelor MCP și integrarea MCP în fluxurile tale 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 componentelor precum Functions, ACA și API Management
  • Alinierea registrului și unelte (1P + 3P)

Dacă ești dezvoltator, creator de unelte sau strateg de produs AI, această zi este plină de informațiile necesare pentru a construi soluții MCP scalabile, sigure și pregătite pentru viitor.

🧭 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 importanța sa în pipeline-urile AI Citește mai mult
01 Explicarea conceptelor de bază Explorare detaliată a conceptelor fundamentale MCP Citește mai mult
02 Securitatea în MCP Amenințări de securitate și cele mai bune practici Citește mai mult
03 Primii pași cu MCP Configurarea mediului, servere/cliens de bază, integrare Citește mai mult
Modulul 3: Construirea primului 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 Consumă servere MCP în VS Code Ghid
3.5 Server SSE Creează servere folosind Server-Sent Events 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ă serverele MCP în producție Ghid
Modulele 4-5: Practic & Avansat
04 Implementare practică SDK-uri, depanare, testare, șabloane reutilizabile pentru prompturi Citește mai mult
05 Subiecte avansate în MCP AI multimodal, scalare, utilizare în mediul enterprise Citește mai mult
5.1 Integrare Azure Integrarea MCP cu Azure Ghid
5.2 Multimodalitate Lucrul cu multiple modalități Ghid
5.3 Demo OAuth2 Implementarea autentificării OAuth2 Ghid
5.4 Contexturi root Înțelegerea și implementarea contexturilor root Ghid
5.5 Rutare Strategii de rutare MCP Ghid
5.6 Eșantionare Tehnici de eșantionare în MCP Ghid
5.7 Scalare Scalarea implementărilor MCP Ghid
5.8 Securitate Considerații avansate de securitate Ghid
5.9 Căutare web Implementarea funcționalității de căutare web Ghid
5.10 Streaming în timp real Construiește funcționalități de streaming în timp real Ghid
5.11 Căutare în timp real 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 eficientă a contextului Ghid
Modulele 6-10: Comunitate & Cele Mai Bune Practici
06 Contribuții Comunitare Cum să contribui la ecosistemul MCP Ghid
07 Lecții din Adoptarea Timpurie Povești din implementări reale 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 AI Toolkit Laborator

💻 Proiecte de Cod Exemplu

Exemple de Bază pentru Calculator MCP

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

Implementări Avansate MCP

Limbaj Descriere Link
C# Exemplu Avansat Vezi Cod
Java Exemplu Aplicație Container Vezi Cod
JavaScript Exemplu Avansat Vezi Cod
Python Implementare Complexă Vezi Cod
TypeScript Exemplu Container Vezi Cod

🎯 Cerințe Prealabile pentru Învățarea MCP

Pentru a profita 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 pentru suport

📚 Ghid de Studiu & Resurse

Acest depozit include mai multe resurse care te vor ajuta să navighezi și să înveți eficient:

Ghid de Studiu

Un Ghid de Studiu cuprinzător este disponibil pentru a te ajuta să navighezi eficient prin acest depozit. Ghidul include:

  • O hartă vizuală a curriculumului cu toate subiectele acoperite
  • Detalii despre fiecare secțiune a depozitului
  • Instrucțiuni despre cum să folosești proiectele exemplu
  • Căi recomandate de învățare pentru diferite niveluri de experiență
  • Resurse suplimentare pentru a-ți completa parcursul de învățare

Jurnal de Modificări

Menținem un Jurnal de Modificări detaliat care urmărește toate actualizările importante ale materialelor curriculumului, inclusiv:

  • Adăugări de conținut nou
  • Modificări structurale
  • Îmbunătățiri de funcționalitate
  • Actualizări ale documentației

🛠️ Cum să Folosești Eficient Acest Curriculum

Fiecare lecție din acest ghid include:

  1. Explicații clare ale conceptelor MCP
  2. Exemple de cod live în mai multe limbaje
  3. Exerciții pentru a construi aplicații MCP reale
  4. Resurse suplimentare pentru învățăcei avansați

🌟 Mulțumiri Comunității

Mulțumiri Microsoft Valued Professional Shivam Goyal pentru contribuțiile importante cu exemple de cod.

📜 Informații despre Licență

Acest conținut este licențiat sub MIT License. Pentru termeni și condiții, vezi LICENSE.

🤝 Ghid pentru Contribuții

Acest proiect primește cu plăcere contribuții și sugestii. Majoritatea contribuțiilor necesită să fii de acord cu un Acord de Licență pentru Contribuitor (CLA) prin care declari că ai dreptul și efectiv ne acorzi drepturile de a folosi contribuția ta. Pentru detalii, vizitează https://cla.opensource.microsoft.com.

Când trimiți un pull request, un bot CLA va determina automat dacă trebuie să furnizezi un CLA și va marca PR-ul corespunzător (de exemplu, verificare de stare, comentariu). Urmează pur și simplu instrucțiunile date de bot. Va trebui să faci acest lucru o singură dată pentru toate depozitele care folosesc CLA-ul nostru.

Acest proiect a adoptat Codul de Conduită Open Source Microsoft. Pentru mai multe informații vezi FAQ Cod de Conduită sau contactează opencode@microsoft.com pentru întrebări sau comentarii suplimentare.

📂 Structura Depozitului

Depozitul este organizat astfel:

  • Curriculum de Bază (00-10): Conținutul principal organizat în zece module secvențiale
  • images/: Diagrame și ilustrații folosite în tot curriculumul
  • translations/: Suport multilingv cu traduceri automate
  • translated_images/: Versiuni localizate ale diagramelor și ilustrațiilor
  • study_guide.md: Ghid cuprinzător pentru navigarea depozitului
  • changelog.md: Evidența tuturor modificărilor importante 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 și alte cursuri! Vezi:

™️ Notă privind Marca Comercială

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 Regulile privind Mărcile Comerciale și Brandul Microsoft. Utilizarea mărcilor comerciale sau logo-urilor Microsoft în versiuni modificate ale acestui proiect nu trebuie să creeze confuzie sau să sugereze sponsorizarea Microsoft. Orice utilizare a mărcilor comerciale sau logo-urilor terților este supusă politicilor acelor terți.

Declinare de responsabilitate:
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 autorizată. Pentru informații critice, se recomandă traducerea profesională realizată de un specialist uman. Nu ne asumăm răspunderea pentru eventualele neînțelegeri sau interpretări greșite rezultate din utilizarea acestei traduceri.