Skip to content

Latest commit

 

History

History
259 lines (194 loc) · 19.6 KB

File metadata and controls

259 lines (194 loc) · 19.6 KB

MCP-kwa-wanaoanza

Wachangiaji wa GitHub Masuala ya GitHub Maombi ya kuvuta GitHub PRs Karibu

Watazamaji wa GitHub Forks za GitHub Nyota za GitHub

Microsoft Azure AI Foundry Discord

Fuata hatua hizi kuanza kutumia rasilimali hizi:

  1. Fork Hifadhi: Bonyeza Forks za GitHub
  2. Clone Hifadhi: 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

Inayosaidiwa kupitia GitHub Action (Imejiendesha & Inasasishwa Kila Wakati)

Kiarabu | Kibengali | Kibulgaria | Kiburma (Myanmar) | Kichina (Rahisi) | Kichina (Kienyeji, Hong Kong) | Kichina (Kienyeji, Macau) | Kichina (Kienyeji, Taiwan) | Kikroeshia | Kicheki | Kideni | Kiholanzi | Kifini | Kifaransa | Kijerumani | Kigiriki | Kiebrania | Kihindi | Kihungari | Kiindonesia | Kiitaliano | Kijapani | Kikorea | Kimalei | Kimarathi | Kinepali | Kinorwe | Kiajemi (Kifarsi) | Kipolandi | Kireno (Brazil) | Kireno (Ureno) | Kipunjabi (Gurmukhi) | Kiromania | Kirusi | Kiserbia (Kisiriliki) | Kislovakia | Kislovenia | Kihispania | Kiswahili | Kiswidi | Kitagalog (Kifilipino) | Kithai | Kituruki | Kiukraini | Kiurdu | Kivietinamu

🚀 Mtaala wa Model Context Protocol (MCP) kwa Wanaoanza

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

🧠 Muhtasari wa Mtaala wa Model Context Protocol

Model Context Protocol (MCP) ni mfumo wa kisasa ulioundwa kusawazisha mwingiliano kati ya mifano ya AI na programu za wateja. Mtaala huu wa chanzo huria unatoa njia ya kujifunza iliyopangiliwa, ikiwa na mifano ya vitendo ya nambari na matumizi halisi, katika lugha maarufu za programu kama C#, Java, JavaScript, TypeScript, na Python.

Ikiwa wewe ni mendelezaji wa AI, mbunifu wa mifumo, au mhandisi wa programu, mwongozo huu ni rasilimali yako kamili ya kufahamu misingi ya MCP na mikakati ya utekelezaji.

🔗 Rasilimali Rasmi za MCP

🧭 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 mifumo ya AI Soma zaidi
01 Maelezo ya Misingi Uchambuzi wa kina wa dhana za msingi za MCP Soma zaidi
02 Usalama katika MCP Vitisho vya usalama na mbinu bora Soma zaidi
03 Kuanza na MCP Usanidi wa mazingira, seva/mteja wa msingi, ujumuishaji 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 Unda mteja wa msingi wa MCP Mwongozo
3.3 Mteja na LLM Jumuisha mifano mikubwa ya lugha Mwongozo
3.4 Ujumuishaji wa VS Code Tumia seva za MCP katika VS Code Mwongozo
3.5 Seva ya stdio Tengeneza seva kwa kutumia usafirishaji wa stdio Mwongozo
3.6 Utiririshaji wa HTTP Tekeleza utiririshaji wa HTTP katika MCP Mwongozo
3.7 Zana ya AI Tumia Zana ya AI na MCP Mwongozo
3.8 Upimaji Pima utekelezaji wa seva yako ya MCP Mwongozo
3.9 Uwekaji Weka seva za MCP katika uzalishaji Mwongozo
Moduli 4-5: Vitendo & Juu Zaidi
04 Utekelezaji wa Vitendo SDKs, urekebishaji wa hitilafu, upimaji, violezo vya maelekezo vinavyoweza kutumika tena Soma zaidi
05 Mada za Juu katika MCP AI ya njia nyingi, upanuzi, matumizi ya kibiashara Soma zaidi
5.1 Ujumuishaji wa Azure Ujumuishaji wa MCP na Azure Mwongozo
5.2 Njia Nyingi Kufanya kazi na njia nyingi Mwongozo
5.3 Demo ya OAuth2 Tekeleza uthibitishaji wa OAuth2 Mwongozo
5.4 Muktadha wa Mizizi Elewa na tekeleza muktadha wa mizizi 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 Masuala ya usalama ya juu Mwongozo
5.9 Utafutaji wa Wavuti Tekeleza uwezo wa utafutaji wa wavuti Mwongozo
5.10 Utiririshaji wa Wakati Halisi Jenga utiririshaji wa wakati halisi Mwongozo
5.11 Utafutaji wa Wakati Halisi Tekeleza utafutaji wa wakati halisi Mwongozo
5.12 Uthibitishaji wa Entra ID Uthibitishaji na Microsoft Entra ID Mwongozo
5.13 Ujumuishaji wa Foundry Jumuisha na Azure AI Foundry Mwongozo
5.14 Uhandisi wa Muktadha Mbinu za uhandisi wa muktadha bora Mwongozo
Moduli 6-10: Jamii & Mbinu Bora
06 Michango ya Jamii Jinsi ya kuchangia kwenye mfumo wa MCP Mwongozo
07 Maarifa kutoka kwa Matumizi ya Mapema Hadithi za utekelezaji wa ulimwengu halisi Mwongozo
08 Mbinu Bora za MCP Utendaji, uvumilivu wa makosa, ustahimilivu Mwongozo
09 Uchunguzi wa Kesi za MCP Mifano ya utekelezaji wa vitendo Mwongozo
10 Warsha ya Vitendo Kujenga Seva ya MCP na Zana ya AI Maabara

💻 Miradi ya Mifano ya Nambari

Sampuli za Msingi za MCP Calculator

Lugha Maelezo Kiungo
C# Mfano wa Seva ya MCP Tazama Nambari
Java MCP Calculator Tazama Nambari
JavaScript Demo ya MCP Tazama Nambari
Python Seva ya MCP Tazama Nambari
TypeScript Mfano wa MCP Tazama Nambari
Rust Mfano wa MCP Tazama Nambari

Utekelezaji wa Juu wa MCP

Lugha Maelezo Kiungo
C# Mfano wa Juu View Code
Java na Spring Mfano wa Programu ya Kontena View Code
JavaScript Mfano wa Juu View Code
Python Utekelezaji Mgumu View Code
TypeScript Mfano wa Kontena View Code

🎯 Mahitaji ya Awali kwa Kujifunza MCP

Ili kufaidika zaidi na mtaala huu, unapaswa kuwa na:

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

  • Uelewa wa modeli ya mteja-server na API

  • Ufahamu wa dhana za REST na HTTP

  • (Hiari) Historia ya dhana za AI/ML

  • Kujiunga na mijadala ya jamii kwa msaada

📚 Mwongozo wa Kujifunza & Rasilimali

Hifadhi hii inajumuisha rasilimali kadhaa za kukusaidia kuvinjari na kujifunza kwa ufanisi:

Mwongozo wa Kujifunza

Mwongozo wa kina wa Study Guide unapatikana kukusaidia kuvinjari hifadhi hii kwa ufanisi. Mwongozo unajumuisha:

  • Ramani ya mtaala ya kuona inayoonyesha mada zote zinazoshughulikiwa
  • Maelezo ya kina ya kila sehemu ya hifadhi
  • Mwongozo wa jinsi ya kutumia miradi ya mfano
  • Njia za kujifunza zinazopendekezwa kwa viwango tofauti vya ujuzi
  • Rasilimali za ziada za kuimarisha safari yako ya kujifunza

Changelog

Tunadumisha Changelog ya kina inayofuatilia masasisho yote muhimu ya vifaa vya mtaala, ikiwa ni pamoja na:

  • Nyongeza mpya za maudhui
  • Mabadiliko ya muundo
  • Uboreshaji wa vipengele
  • Masasisho ya nyaraka

🛠️ Jinsi ya Kutumia Mtaala Huu kwa Ufanisi

Kila somo katika mwongozo huu linajumuisha:

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

Matukio

Jiandae kwa siku mbili za maarifa ya kina ya kiufundi, muunganisho wa jamii, na kujifunza kwa vitendo katika MCP Dev Days, tukio la mtandaoni lililojitolea kwa Model Context Protocol (MCP) — kiwango kipya kinachounganisha mifano ya AI na zana wanazotegemea. Unaweza kutazama MCP Dev Days kwa kujisajili kwenye ukurasa wetu wa tukio: https://aka.ms/mcpdevdays.

Ni kuhusu kuwawezesha watengenezaji kutumia MCP katika mtiririko wao wa kazi wa maendeleo na kusherehekea jamii ya ajabu ya MCP. Tutakuwa na wanajamii na washirika kama Arcade, Block, Okta, na Neon kuona jinsi wanavyoshirikiana na Microsoft kuunda mfumo wa MCP wazi na unaoweza kupanuliwa.
Maonyesho ya ulimwengu halisi katika VS Code, Visual Studio, GitHub Copilot, na zana maarufu za jamii
Mitiririko ya kazi ya maendeleo inayotegemea muktadha
Vipindi vinavyoongozwa na jamii na maarifa
Ikiwa unaanza tu na MCP au tayari unajenga nayo, Siku ya 1 itaweka msingi wa msukumo na hatua zinazoweza kuchukuliwa.

Ni kwa wajenzi wa MCP. Tutazama kwa kina katika mikakati ya utekelezaji na mazoea bora ya kuunda seva za MCP na kuunganisha MCP katika mitiririko yako ya kazi ya AI.

Mada zinajumuisha:

  • Kujenga Seva za MCP na kuzihusisha katika uzoefu wa mawakala
  • Maendeleo yanayoendeshwa na maelekezo
  • Mazoea bora ya usalama
  • Kutumia vipengele kama Functions, ACA, na API Management
  • Ulinganifu wa rejista na zana (1P + 3P)

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

MCP Boot Camp Agosti 2025

Jifunze katika vipindi vya video vya kina jinsi ya kuunda seva za MCP, kuunganisha na VS Code, na kupeleka kitaalamu kwenye Azure kulingana na maudhui kutoka kwa mtaala wa MCP kwa Kompyuta. Ondoka na ujuzi wa vitendo katika teknolojia ambayo kampuni kubwa tayari zinatumia.

🌟 Shukrani za Jamii

Shukrani kwa Microsoft Valued Professional Shivam Goyal kwa kuchangia sampuli muhimu za msimbo.

📜 Taarifa ya Leseni

Maudhui haya yamepewa leseni chini ya MIT License. Kwa masharti na hali, angalia LICENSE.

🤝 Miongozo ya Mchango

Mradi huu unakaribisha michango na mapendekezo. Michango mingi inahitaji ukubali Mkataba wa Leseni ya Mchangiaji (CLA) unaotangaza kuwa una haki ya, na kwa kweli unatoa, haki kwetu kutumia mchango wako. Kwa maelezo zaidi, tembelea
https://cla.opensource.microsoft.com.

Unapowasilisha ombi la kuvuta, bot ya CLA itaamua kiotomatiki ikiwa unahitaji kutoa CLA na kupamba PR ipasavyo (mfano, ukaguzi wa hali, maoni). Fuata tu maagizo yaliyotolewa na bot. Utahitaji kufanya hivyo mara moja tu katika hifadhi zote zinazotumia CLA yetu.

Mradi huu umechukua Microsoft Open Source Code of Conduct.
Kwa maelezo zaidi angalia Code of Conduct FAQ au wasiliana na opencode@microsoft.com kwa maswali au maoni ya ziada.

📂 Muundo wa Hifadhi

Hifadhi imepangwa kama ifuatavyo:

  • Mtaala wa Msingi (00-10): Maudhui kuu yaliyopangwa katika moduli kumi mfululizo
  • images/: Michoro na vielelezo vinavyotumika katika mtaala
  • translations/: Usaidizi wa lugha nyingi na tafsiri za kiotomatiki
  • translated_images/: Matoleo ya ndani ya michoro na vielelezo
  • study_guide.md: Mwongozo wa kina wa kuvinjari hifadhi
  • changelog.md: Rekodi ya mabadiliko yote muhimu ya vifaa vya mtaala
  • mcp.json: Faili ya usanidi wa vipimo vya MCP
  • CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Nyaraka za usimamizi wa mradi

🎒 Kozi Nyingine

Timu yetu inazalisha kozi nyingine! Angalia:

™️ Taarifa ya Alama ya Biashara

Mradi huu unaweza kuwa na alama za biashara au nembo za miradi, bidhaa, au huduma. Matumizi yaliyoidhinishwa ya alama za biashara au nembo za Microsoft yanapaswa kufuata na lazima yafuate
Microsoft's Trademark & Brand Guidelines.
Matumizi ya alama za biashara au nembo za Microsoft katika matoleo yaliyorekebishwa ya mradi huu hayapaswi kusababisha mkanganyiko au kuashiria udhamini wa Microsoft.
Matumizi yoyote ya alama za biashara au nembo za wahusika wengine yanapaswa kufuata sera za wahusika hao.


Kanusho:
Hati hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI Co-op Translator. Ingawa tunajitahidi kwa usahihi, tafadhali fahamu kuwa tafsiri za kiotomatiki zinaweza kuwa na makosa au kutokuwa sahihi. Hati ya asili katika lugha yake ya awali inapaswa kuzingatiwa kama chanzo cha mamlaka. Kwa taarifa muhimu, inashauriwa kutumia huduma ya tafsiri ya kitaalamu ya binadamu. Hatutawajibika kwa kutoelewana au tafsiri zisizo sahihi zinazotokana na matumizi ya tafsiri hii.