Skip to content

Latest commit

 

History

History
256 lines (187 loc) · 19 KB

File metadata and controls

256 lines (187 loc) · 19 KB

MCP-for-beginners

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Azure AI Foundry Discord

Fuata hatua hizi kuanza kutumia rasilimali hizi:

  1. Fanya Fork ya Repositori: Bonyeza GitHub forks
  2. Nakili Repositori: git clone https://github.com/microsoft/mcp-for-beginners.git
  3. Jiunge na Azure AI Foundry Discord na kutana na wataalamu na waendelezaji wenzako

🌐 Msaada wa Lugha Nyingi

Unaungwa mkono kupitia GitHub Action (Moja kwa moja & Daima Imesasishwa)

French | Spanish | German | Russian | Arabic | Persian (Farsi) | Urdu | Chinese (Simplified) | Chinese (Traditional, Macau) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Taiwan) | Japanese | Korean | Hindi | Bengali | Marathi | Nepali | Punjabi (Gurmukhi) | Portuguese (Portugal) | Portuguese (Brazil) | Italian | Polish | Turkish | Greek | Thai | Swedish | Danish | Norwegian | Finnish | Dutch | Hebrew | Vietnamese | Indonesian | Malay | Tagalog (Filipino) | Swahili | Hungarian | Czech | Slovak | Romanian | Bulgarian | Serbian (Cyrillic) | Croatian | Slovenian | Ukrainian | Burmese (Myanmar)

🚀 Mtaala wa Model Context Protocol (MCP) kwa Waanzilishi

Jifunze MCP kwa Mifano ya Vitendo ya Msimbo katika C#, Java, JavaScript, Python, na TypeScript

🧠 Muhtasari wa Mtaala wa Model Context Protocol

Model Context Protocol (MCP) ni mfumo wa kisasa uliobuniwa kuweka viwango vya mawasiliano kati ya mifano ya AI na programu za wateja. Mtaala huu wa chanzo huria unatoa njia ya kujifunza iliyopangwa, ikiwa na mifano ya vitendo ya kuandika msimbo na matumizi halisi, kwa lugha maarufu za programu kama C#, Java, JavaScript, TypeScript, na Python.

Iwe wewe ni mtaalamu wa AI, mbunifu wa mifumo, au mhandisi wa programu, mwongozo huu ni rasilimali kamili ya kukufundisha misingi ya MCP na mikakati ya utekelezaji.

🔗 Rasilimali Rasmi za MCP

Jiunge nasi kwa MCP Dev Days tarehe 29-30 Julai 2025

Jiandae kwa siku mbili za maarifa ya kina ya kiufundi, kuungana na jumuiya, na kujifunza kwa vitendo katika MCP Dev Days, tukio la mtandaoni lililojikita kwenye Model Context Protocol (MCP) — kiwango kinachochipukia kinachounganisha mifano ya AI na zana wanazotegemea.

➡️ Jisajili kwa MCP Dev Days

Unaweza kutazama MCP Dev Days kwa kujisajili kwenye ukurasa wetu wa tukio: https://aka.ms/mcpdevdays. Kutoka hapo, utaweza kuungana na mtiririko wa moja kwa moja kwenye YouTube au Twitch. Yote yaliyorekodiwa yatapatikana baadaye kwenye kituo cha Microsoft Developer YouTube. Msimbo wa chanzo wa maonyesho pia utapatikana kwenye GitHub.

Maelezo ya Tukio

  • Tarehe: Julai 29 (Siku ya 1) & Julai 30 (Siku ya 2)
  • Muda: Saa 3:00 asubuhi PST kila siku
  • Mahali: Mtandaoni – jiunge kutoka mahali popote!

Siku ya 1: Uzalishaji wa MCP, Zana za Maendeleo, & Jumuiya:

Ni kuhusu kuwawezesha waendelezaji kutumia MCP katika mtiririko wao wa kazi na kusherehekea jumuiya ya kushangaza ya MCP. Tutakuwa na wanajumuiya na washirika kama Arcade, Block, Okta, na Neon kuona jinsi wanavyoshirikiana na Microsoft kuunda mfumo wa MCP ulio wazi na unaoweza kupanuliwa. Maonyesho halisi katika VS Code, Visual Studio, GitHub Copilot, na zana maarufu za jumuiya
Mtiririko wa kazi wa maendeleo unaoendeshwa na muktadha
Vikao na maarifa yanayoongozwa na jumuiya
Iwe unaanza tu na MCP au tayari unaunda nayo, Siku ya 1 itakuandaa kwa msukumo na mambo ya kutekeleza.

Siku ya 2: Jenga Seva za MCP kwa Kujiamini

Ni kwa ajili ya wajenzi wa MCP. Tutachambua mikakati ya utekelezaji na mbinu bora za kuunda seva za MCP na kuingiza MCP katika mtiririko wako wa AI.

Mada zitajumuisha:

  • Kujenga seva za MCP na kuziingiza katika uzoefu wa mawakala
  • Maendeleo yanayoendeshwa na maelekezo
  • Mbinu bora za usalama
  • Kutumia vipengele kama Functions, ACA, na Usimamizi wa API
  • Ulinganifu wa rejista na zana (1P + 3P)

Ikiwa wewe ni mtaalamu wa maendeleo, mjenzi wa zana, au mkakati wa bidhaa za AI, siku hii imejaa maarifa unayohitaji kujenga suluhisho za MCP zinazoweza kupanuka, salama, na tayari kwa siku zijazo.

🧭 Muhtasari wa Mtaala wa MCP

📚 Muundo Kamili wa Mtaala

Moduli Mada Maelezo Kiungo
Moduli 1-3: Misingi
00 Utangulizi wa MCP Muhtasari wa Model Context Protocol na umuhimu wake katika mizunguko ya AI Soma zaidi
01 Maana za Msingi Zimefafanuliwa Uchunguzi wa kina wa dhana kuu za MCP Soma zaidi
02 Usalama katika MCP Vitisho vya usalama na mbinu bora Soma zaidi
03 Kuanzisha na MCP Usanidi wa mazingira, seva/ wateja wa msingi, uingizaji Soma zaidi
Moduli 3: Kujenga Seva na Mteja Wako wa Kwanza
3.1 Seva ya Kwanza Tengeneza seva yako ya kwanza ya MCP Mwongozo
3.2 Mteja wa Kwanza Tengeneza mteja wa msingi wa MCP Mwongozo
3.3 Mteja na LLM Unganisha mifano mikubwa ya lugha Mwongozo
3.4 Uingizaji wa VS Code Tumia seva za MCP katika VS Code Mwongozo
3.5 Seva ya SSE Tengeneza seva kwa kutumia Matukio Yanayotumwa na Seva Mwongozo
3.6 Utoaji wa HTTP Tekeleza utoaji wa HTTP katika MCP Mwongozo
3.7 Zana za AI Tumia Zana za AI na MCP Mwongozo
3.8 Upimaji Jaribu utekelezaji wa seva yako ya MCP Mwongozo
3.9 Utekelezaji Weka seva za MCP katika uzalishaji Mwongozo
Moduli 4-5: Vitendo & Kipekee
04 Utekelezaji wa Vitendo SDK, utambuzi wa hitilafu, upimaji, templeti za maelekezo zinazoweza kutumika tena Soma zaidi
05 Mada za Juu katika MCP AI ya aina nyingi, upanuzi, matumizi ya biashara Soma zaidi
5.1 Uingizaji wa Azure Uingizaji wa MCP na Azure Mwongozo
5.2 Aina Nyingi Kufanya kazi na aina nyingi Mwongozo
5.3 Onyesho la OAuth2 Tekeleza uthibitishaji wa OAuth2 Mwongozo
5.4 Muktadha wa Msingi Elewa na utekeleze muktadha wa msingi Mwongozo
5.5 Uelekezaji Mikakati ya uelekezaji wa MCP Mwongozo
5.6 Sampuli Mbinu za sampuli katika MCP Mwongozo
5.7 Upanuzi Panua utekelezaji wa MCP Mwongozo
5.8 Usalama Mambo ya usalama ya hali ya juu Mwongozo
5.9 Utafutaji wa Wavuti Tekeleza uwezo wa utafutaji wa wavuti Mwongozo
5.10 Utoaji wa Moja kwa Moja Jenga utendaji wa utoaji wa moja kwa moja Mwongozo
5.11 Utafutaji wa Moja kwa Moja Tekeleza utafutaji wa moja kwa moja Mwongozo
5.12 Entra ID Auth Uthibitishaji kwa Microsoft Entra ID Mwongozo
5.13 Uunganishaji wa Foundry Unganisha na Azure AI Foundry Mwongozo
5.14 Uhandisi wa Muktadha Mbinu za uhandisi wa muktadha unaofaa Mwongozo
Moduli 6-10: Jamii & Mbinu Bora
06 Michango ya Jamii Jinsi ya kuchangia mfumo wa MCP Mwongozo
07 Maarifa kutoka kwa Matumizi ya Awali Hadithi za utekelezaji halisi Mwongozo
08 Mbinu Bora za MCP Utendaji, uvumilivu wa hitilafu, uimara Mwongozo
09 Masomo ya Kesi za MCP Mifano ya utekelezaji wa vitendo Mwongozo
10 Warsha ya Vitendo Kujenga Server ya MCP kwa kutumia AI Toolkit Maabara

💻 Miradi ya Mifano ya Msimbo

Mifano ya Msingi ya Kihesabu ya MCP

Lugha Maelezo Kiungo
C# Mfano wa Server ya MCP Tazama Msimbo
Java Kihesabu cha MCP Tazama Msimbo
JavaScript Onyesho la MCP Tazama Msimbo
Python Server ya MCP Tazama Msimbo
TypeScript Mfano wa MCP Tazama Msimbo

Utekelezaji wa Juu wa MCP

Lugha Maelezo Kiungo
C# Mfano wa Juu Tazama Msimbo
Java Mfano wa Programu ya Kontena Tazama Msimbo
JavaScript Mfano wa Juu Tazama Msimbo
Python Utekelezaji Changamano Tazama Msimbo
TypeScript Mfano wa Kontena Tazama Msimbo

🎯 Masharti ya Awali kwa Kujifunza MCP

Ili kupata faida kubwa kutoka kwa mtaala huu, unapaswa kuwa na:

  • Ujuzi wa msingi wa programu katika angalau moja ya lugha zifuatazo: C#, Java, JavaScript, Python, au TypeScript

  • Uelewa wa mfano wa mteja-server na APIs

  • Uzoefu na dhana za REST na HTTP

  • (Hiari) Asili ya dhana za AI/ML

  • Kushiriki katika mijadala ya jamii yetu kwa msaada

📚 Mwongozo wa Kusoma & Rasilimali

Hifadhi hii ina rasilimali kadhaa zitakazokusaidia kuvinjari na kujifunza kwa ufanisi:

Mwongozo wa Kusoma

MWONGOZO WA KUSOMA kamili upo kusaidia kuvinjari hifadhi hii kwa ufanisi. Mwongozo huu unajumuisha:

  • Ramani ya mtaala yenye picha inayoonyesha mada zote zilizojumuishwa
  • Ufafanuzi wa kina wa kila sehemu ya hifadhi
  • Mwongozo wa jinsi ya kutumia miradi ya mfano
  • Njia za kujifunza zilizopendekezwa kwa viwango tofauti vya ujuzi
  • Rasilimali za ziada za kuimarisha safari yako ya kujifunza

Mabadiliko ya Toleo

Tunadumisha Mabadiliko ya Toleo yenye rekodi ya masasisho yote muhimu ya vifaa vya mtaala, ikijumuisha:

  • Maudhui mapya yaliyoongezwa
  • Mabadiliko ya muundo
  • Maboresho ya vipengele
  • Sasisho za nyaraka

🛠️ Jinsi ya Kutumia Mtaala Huu kwa Ufanisi

Kila somo katika mwongozo huu linajumuisha:

  1. Maelezo wazi ya dhana za MCP
  2. Mifano ya msimbo wa moja kwa moja katika lugha mbalimbali
  3. Mazoezi ya kujenga programu halisi za MCP
  4. Rasilimali za ziada kwa wanafunzi wa hali ya juu

🌟 Shukrani kwa Jamii

Shukrani kwa Microsoft Valued Professional Shivam Goyal kwa kuchangia mifano muhimu ya msimbo.

📜 Taarifa za Leseni

Yaliyomo haya yamepewa leseni chini ya Leseni ya MIT. Kwa masharti na vigezo, angalia LICENSE.

🤝 Miongozo ya Michango

Mradi huu unakaribisha michango na mapendekezo. Michango mingi inahitaji kukubaliana na Makubaliano ya Leseni ya Mchango (CLA) yanayothibitisha kuwa una haki na kwa kweli unatupa haki za kutumia mchango wako. Kwa maelezo, tembelea
https://cla.opensource.microsoft.com.

Unapowasilisha ombi la pull request, bot wa CLA atabaini moja kwa moja kama unahitaji kutoa CLA na kuandaa PR ipasavyo (mfano, ukaguzi wa hali, maoni). Fuata tu maelekezo yanayotolewa na bot. Hii itahitajika mara moja tu kwa hifadhi zote zinazotumia CLA yetu.

Mradi huu umechukua Kanuni za Maadili za Chanzo Huria za Microsoft. Kwa taarifa zaidi angalia Maswali Yanayoulizwa Mara kwa Mara kuhusu Kanuni za Maadili au wasiliana na opencode@microsoft.com kwa maswali au maoni zaidi.

📂 Muundo wa Hifadhi

Hifadhi imepangwa kama ifuatavyo:

  • Mtaala Msingi (00-10): Maudhui makuu yamepangwa katika moduli kumi mfululizo
  • images/: Michoro na picha zinazotumika katika mtaala mzima
  • translations/: Msaada wa lugha nyingi kwa tafsiri za moja kwa moja
  • translated_images/: Toleo la picha na michoro iliyotafsiriwa
  • study_guide.md: Mwongozo kamili wa kuvinjari hifadhi
  • changelog.md: Rekodi ya mabadiliko yote muhimu ya vifaa vya mtaala
  • mcp.json: Faili la usanidi wa sifa za MCP
  • CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Nyaraka za utawala wa mradi

🎒 Kozi Nyingine

Timu yetu hutengeneza kozi nyingine! Angalia:

™️ Taarifa za Alama za Biashara

Mradi huu unaweza kuwa na alama za biashara au nembo za miradi, bidhaa, au huduma. Matumizi yaliyoruhusiwa ya alama za biashara au nembo za Microsoft yanategemea na lazima yafuatilie
Mwongozo wa Alama za Biashara & Brand wa Microsoft.
Matumizi ya alama za biashara au nembo za Microsoft katika matoleo yaliyobadilishwa ya mradi huu hayapaswi kusababisha mkanganyiko au kuashiria udhamini wa Microsoft.
Matumizi yoyote ya alama za biashara au nembo za wahusika wengine yanategemea sera za wahusika hao.

Kiarifu cha Msamaha:
Hati hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI Co-op Translator. Ingawa tunajitahidi kuhakikisha usahihi, tafadhali fahamu kwamba tafsiri za kiotomatiki zinaweza kuwa na makosa au upungufu wa usahihi. Hati ya asili katika lugha yake ya asili inapaswa kuchukuliwa kama chanzo cha mamlaka. Kwa taarifa muhimu, tafsiri ya kitaalamu inayofanywa na binadamu inashauriwa. Hatuna dhamana kwa kutoelewana au tafsiri potofu zinazotokana na matumizi ya tafsiri hii.