MCP-for-beginners

Fuata hatua hizi kuanza kutumia rasilimali hizi:

Fork Hifadhi: Bonyeza
Clone Hifadhi: git clone https://github.com/microsoft/mcp-for-beginners.git
Jiunge na Azure AI Foundry Discord na kutana na wataalamu na watengenezaji wenzako

🌐 Msaada wa Lugha Nyingi

Inayoungwa mkono kupitia GitHub Action (Imefanywa Kiotomatiki & Daima Imeboreshwa)

🚀 Mtaala wa Model Context Protocol (MCP) kwa Kompyuta

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 kuunda viwango vya mawasiliano kati ya mifano ya AI na programu za wateja. Mtaala huu wa chanzo huria unatoa njia ya kujifunza iliyopangwa, ikijumuisha mifano ya vitendo ya nambari na matumizi halisi, katika lugha maarufu za programu kama C#, Java, JavaScript, TypeScript, na Python.

Ikiwa wewe ni mtengenezaji 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

📘 Hati za MCP – Mafunzo ya kina na miongozo ya watumiaji
📜 Maelezo ya MCP – Muundo wa itifaki na marejeleo ya kiufundi
📜 Maelezo Asilia ya MCP – Marejeleo ya kiufundi ya awali (yanaweza kuwa na maelezo ya ziada)
🧑‍💻 Hifadhi ya MCP GitHub – SDKs za chanzo huria, zana, na mifano ya nambari
🌐 Jamii ya MCP – Jiunge na mijadala na changia kwa jamii

🧭 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	Ufafanuzi wa Dhana za Msingi	Uchunguzi 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 wa Kwanza
3.1	Seva ya Kwanza	Unda seva yako ya kwanza ya MCP	Mwongozo
3.2	Mteja wa Kwanza	Tengeneza 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	Unda seva kwa kutumia usafirishaji wa stdio	Mwongozo
3.6	Ustreaming wa HTTP	Tekeleza ustreaming 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
3.10	Matumizi ya seva ya hali ya juu	Tumia seva za hali ya juu kwa matumizi ya vipengele vya hali ya juu na usanifu ulioboreshwa	Mwongozo
3.11	Uthibitishaji rahisi	Sura inayoonyesha uthibitishaji kutoka mwanzo na RBAC	Mwongozo
Moduli 4-5: Vitendo & Hali ya Juu
04	Utekelezaji wa Vitendo	SDKs, urekebishaji wa hitilafu, upimaji, templeti za maelezo zinazoweza kutumika tena	Soma zaidi
05	Mada za Juu katika MCP	AI ya hali nyingi, upanuzi, matumizi ya biashara	Soma zaidi
5.1	Ujumuishaji wa Azure	Ujumuishaji wa MCP na Azure	Mwongozo
5.2	Hali nyingi	Kufanya kazi na hali 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	Usafirishaji	Mikakati ya usafirishaji ya MCP	Mwongozo
5.6	Sampuli	Mbinu za sampuli katika MCP	Mwongozo
5.7	Upanuzi	Panua utekelezaji wa MCP	Mwongozo
5.8	Usalama	Mazingatio ya hali ya juu ya usalama	Mwongozo
5.9	Utafutaji wa Wavuti	Tekeleza uwezo wa utafutaji wa wavuti	Mwongozo
5.10	Ustreaming wa Wakati Halisi	Jenga utendaji wa ustreaming 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
5.15	Usafirishaji wa MCP wa Kawaida	Utekelezaji wa Usafirishaji wa Kawaida	Mwongozo
Moduli 6-10: Jamii & Mbinu Bora
06	Michango ya Jamii	Jinsi ya kuchangia kwa mfumo wa MCP	Mwongozo
07	Maarifa kutoka kwa Matumizi ya Mapema	Hadithi za utekelezaji halisi	Mwongozo
08	Mbinu Bora za MCP	Utendaji, uvumilivu wa hitilafu, 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
Moduli 11: Maabara ya Vitendo ya Seva ya MCP
11	Ujumuishaji wa Hifadhidata ya Seva ya MCP	Njia ya kujifunza ya maabara 13 ya kina kwa ujumuishaji wa PostgreSQL	Maabara
11.1	Utangulizi	Muhtasari wa MCP na ujumuishaji wa hifadhidata na matumizi ya uchambuzi wa rejareja	Maabara 00
11.2	Muundo wa Msingi	Kuelewa muundo wa seva ya MCP, tabaka za hifadhidata, na mifumo ya usalama	Lab 01
11.3	Usalama & Multi-Tenancy	Usalama wa kiwango cha safu, uthibitishaji, na ufikiaji wa data ya wateja wengi	Lab 02
11.4	Usanidi wa Mazingira	Kuandaa mazingira ya maendeleo, Docker, rasilimali za Azure	Lab 03
11.5	Muundo wa Hifadhidata	Usanidi wa PostgreSQL, muundo wa schema ya rejareja, na data ya mfano	Lab 04
11.6	Utekelezaji wa Seva ya MCP	Kujenga seva ya FastMCP yenye ujumuishaji wa hifadhidata	Lab 05
11.7	Uundaji wa Zana	Kuunda zana za maswali ya hifadhidata na uchunguzi wa schema	Lab 06
11.8	Utafutaji wa Kisemantiki	Kutekeleza embeddings za vector na Azure OpenAI na pgvector	Lab 07
11.9	Upimaji & Urekebishaji	Mikakati ya upimaji, zana za kurekebisha, na mbinu za uthibitishaji	Lab 08
11.10	Ujumuishaji wa VS Code	Kuseti ujumuishaji wa MCP kwenye VS Code na matumizi ya AI Chat	Lab 09
11.11	Mikakati ya Utekelezaji	Utekelezaji wa Docker, Azure Container Apps, na masuala ya upanuzi	Lab 10
11.12	Ufuatiliaji	Application Insights, logging, na ufuatiliaji wa utendaji	Lab 11
11.13	Mazoezi Bora	Uboreshaji wa utendaji, kuimarisha usalama, na vidokezo vya uzalishaji	Lab 12

💻 Miradi ya Mfano 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	MCP Demo	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	Tazama Nambari
Java na Spring	Mfano wa App ya Kontena	Tazama Nambari
JavaScript	Mfano wa Juu	Tazama Nambari
Python	Utekelezaji wa Kiwango cha Juu	Tazama Nambari
TypeScript	Mfano wa Kontena	Tazama Nambari

🎯 Mahitaji ya Kujifunza MCP

Ili kufaidika zaidi na mtaala huu, unapaswa kuwa na:

Maarifa ya msingi ya programu katika angalau moja ya lugha zifuatazo: C#, Java, JavaScript, Python, au TypeScript
Uelewa wa modeli ya mteja-seva na API
Uzoefu wa dhana za REST na HTTP
(Hiari) Msingi wa 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 Mwongozo wa Kujifunza unapatikana kukusaidia kuvinjari hifadhi hii kwa ufanisi. Mwongozo unajumuisha:

Ramani ya mtaala inayoonyesha mada zote zinazoshughulikiwa
Ufafanuzi wa kina wa 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
Sasisho za nyaraka

🛠️ Jinsi ya Kutumia Mtaala Huu kwa Ufanisi

Kila somo katika mwongozo huu linajumuisha:

Maelezo wazi ya dhana za MCP
Sampuli za nambari za moja kwa moja katika lugha mbalimbali
Mazoezi ya kujenga programu halisi za MCP
Rasilimali za ziada kwa wanafunzi wa kiwango cha juu

Matukio

MCP Dev Days Julai 2025

➡️Tazama kwa Mahitaji - MCP Dev Days

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.

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

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 kupanuka.

Maonyesho halisi ya ulimwengu kote VS Code, Visual Studio, GitHub Copilot, na zana maarufu za jamii
Mtiririko wa kazi wa maendeleo unaoendeshwa na muktadha
Vipindi vinavyoongozwa na jamii na maarifa
Ikiwa unaanza tu na MCP au tayari unajenga nayo, Siku ya 1 itaweka msingi wa msukumo na vidokezo vya utekelezaji.

Siku ya 2: Jenga Seva za MCP kwa Ujasiri

Ni kwa watengenezaji wa MCP. Tutazama kwa kina mikakati ya utekelezaji na mazoea bora ya kuunda seva za MCP na kuunganisha MCP katika mtiririko wako wa kazi wa AI.

Mada zinajumuisha:

Kujenga Seva za MCP na kuzijumuisha katika uzoefu wa mawakala
Maendeleo yanayoendeshwa na maelezo
Mazoea bora ya usalama
Kutumia vizuizi vya ujenzi 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 kupanuka, 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 kutekeleza kitaalamu kwenye Azure kulingana na maudhui kutoka mtaala wa MCP kwa Kompyuta. Ondoka na ujuzi wa vitendo katika teknolojia ambayo kampuni kubwa tayari zinatumia.

➡️Tazama kwa Mahitaji MCP Bootcamp | Kiingereza

➡️Tazama kwa Mahitaji MCP Bootcamp | Brasil

➡️Tazama kwa Mahitaji MCP Bootcamp | Kihispania

Jifunze MCP na C# - Mfululizo wa Mafunzo

Jifunze kuhusu Model Context Protocol (MCP), mfumo wa kisasa ulioundwa kuunda kiwango cha mawasiliano kati ya mifano ya AI na programu za wateja. Kupitia kipindi hiki kinachofaa kwa wanaoanza, tutakutambulisha kwa MCP na kukuongoza kuunda seva yako ya kwanza ya 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

🌟 Shukrani kwa Jamii

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

📜 Taarifa za Leseni

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

🤝 Miongozo ya Mchango

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

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

Mradi huu umechukua Kanuni ya Maadili ya Microsoft Open Source. Kwa maelezo zaidi angalia Maswali Yanayoulizwa Mara kwa Mara ya Kanuni ya Maadili au wasiliana na opencode@microsoft.com kwa maswali au maoni ya ziada.

📂 Muundo wa Hifadhi

Hifadhi imepangwa kama ifuatavyo:

Mtaala wa Msingi (00-11): Maudhui kuu yaliyopangwa katika moduli kumi na moja mfululizo, ikiwa ni pamoja na maabara kamili ya ujumuishaji wa hifadhidata
11-MCPServerHandsOnLabs/: Njia ya kujifunza ya maabara 13 ya kujenga seva za MCP zinazofaa kwa uzalishaji na ujumuishaji wa PostgreSQL
images/: Michoro na vielelezo vinavyotumika katika mtaala
translations/: Usaidizi wa lugha nyingi na tafsiri za kiotomatiki
translated_images/: Matoleo yaliyotafsiriwa 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 maelezo ya MCP
CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Nyaraka za usimamizi wa mradi

🎒 Kozi Nyingine

Timu yetu inazalisha kozi nyingine! Angalia:

™️ Tangazo la 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 Miongozo ya Alama ya Biashara na Nembo ya Microsoft. 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.

Kupata Msaada

Ikiwa umekwama au una maswali kuhusu kujenga programu za AI, jiunge:

Ikiwa una maoni kuhusu bidhaa au makosa wakati wa kujenga, tembelea:

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