![MCP-for-beginners](../../translated_images/sw/mcp-beginners.2ce2b317996369ff.webp) [![GitHub contributors](https://img.shields.io/github/contributors/microsoft/mcp-for-beginners.svg)](https://GitHub.com/microsoft/mcp-for-beginners/graphs/contributors) [![GitHub issues](https://img.shields.io/github/issues/microsoft/mcp-for-beginners.svg)](https://GitHub.com/microsoft/mcp-for-beginners/issues) [![GitHub pull-requests](https://img.shields.io/github/issues-pr/microsoft/mcp-for-beginners.svg)](https://GitHub.com/microsoft/mcp-for-beginners/pulls) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com) [![GitHub watchers](https://img.shields.io/github/watchers/microsoft/mcp-for-beginners.svg?style=social&label=Watch)](https://GitHub.com/microsoft/mcp-for-beginners/watchers) [![GitHub forks](https://img.shields.io/github/forks/microsoft/mcp-for-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/mcp-for-beginners/fork) [![GitHub stars](https://img.shields.io/github/stars/microsoft/mcp-for-beginners?style=social&label=Star)](https://GitHub.com/microsoft/mcp-for-beginners/stargazers) [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) Fuata hatua hizi kuanza kutumia rasilimali hizi: 1. **Fukua Hifadhi**: Bonyeza [![GitHub forks](https://img.shields.io/github/forks/microsoft/mcp-for-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/mcp-for-beginners/fork) 2. **Nakili Hifadhi**: `git clone https://github.com/microsoft/mcp-for-beginners.git` 3. **Jiunge Na** [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) ### 🌐 Msaada wa Lugha Nyingi #### Unaungwa mkono kupitia Kitendo cha GitHub (Kiotomatiki & Daima Kifahari) [Arabic](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgarian](../bg/README.md) | [Burmese (Myanmar)](../my/README.md) | [Chinese (Simplified)](../zh-CN/README.md) | [Chinese (Traditional, Hong Kong)](../zh-HK/README.md) | [Chinese (Traditional, Macau)](../zh-MO/README.md) | [Chinese (Traditional, Taiwan)](../zh-TW/README.md) | [Croatian](../hr/README.md) | [Czech](../cs/README.md) | [Danish](../da/README.md) | [Dutch](../nl/README.md) | [Estonian](../et/README.md) | [Finnish](../fi/README.md) | [French](../fr/README.md) | [German](../de/README.md) | [Greek](../el/README.md) | [Hebrew](../he/README.md) | [Hindi](../hi/README.md) | [Hungarian](../hu/README.md) | [Indonesia](../id/README.md) | [Italian](../it/README.md) | [Japanese](../ja/README.md) | [Kannada](../kn/README.md) | [Khmer](../km/README.md) | [Korean](../ko/README.md) | [Lithuanian](../lt/README.md) | [Malay](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Nigerian Pidgin](../pcm/README.md) | [Norwegian](../no/README.md) | [Persian (Farsi)](../fa/README.md) | [Polish](../pl/README.md) | [Portuguese (Brazil)](../pt-BR/README.md) | [Portuguese (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romanian](../ro/README.md) | [Russian](../ru/README.md) | [Serbian (Cyrillic)](../sr/README.md) | [Slovak](../sk/README.md) | [Slovenian](../sl/README.md) | [Spanish](../es/README.md) | [Swahili](./README.md) | [Swedish](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turkish](../tr/README.md) | [Ukrainian](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamese](../vi/README.md) > **Ungependa Nakili Mahali Mbele?** > > Hifadhi hii ina tafsiri zaidi ya 50 za lugha ambazo huongeza kwa kiasi kikubwa ukubwa wa kupakua. Ili kunakili bila tafsiri, tumia sparse checkout: > > **Bash / macOS / Linux:** > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git > cd mcp-for-beginners > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` > > **CMD (Windows):** > ```cmd > git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git > cd mcp-for-beginners > git sparse-checkout set --no-cone "/*" "!translations" "!translated_images" > ``` > > Hii itakupa kila kitu unachohitaji kumaliza kozi kwa upakuaji wa kasi zaidi. # 🚀 Mtaala wa Protocol ya Muktadha wa Mfano (MCP) kwa Waanzilishi ## **Jifunze MCP kwa Mifano ya Kanuni ya Vitendo katika C#, Java, JavaScript, Rust, Python, na TypeScript** ## 🧠 Muhtasari wa Mtaala wa Protocol ya Muktadha wa Mfano Karibu kwenye safari yako ya Protocol ya Muktadha wa Mfano! Ikiwa umewahi kujiuliza jinsi programu za AI zinavyowasiliana na zana na huduma tofauti, unakaribia kugundua suluhisho rahisi linalobadilisha jinsi watengenezaji wanavyojenga mifumo ya akili. Fikiria MCP kama mtafsiri wa ulimwengu kwa programu za AI - kama vile viunganishi vya USB vinavyokuruhusu kuunganisha kifaa chochote kwa kompyuta yako, MCP inaruhusu mifano ya AI kuunganishwa na zana au huduma yoyote kwa njia iliyojumuishwa. Iwe unajenga chatbot yako ya kwanza au unafanya kazi kwenye mitiririko tata ya AI, kuelewa MCP kutakupa uwezo wa kuunda programu zenye uwezo zaidi na zinazobadilika. Mtaala huu umeundwa kwa subira na uangalifu kwa ajili ya safari yako ya kujifunza. Tutaanza na dhana rahisi unazozifahamu na polepole kujenga utaalamu wako kupitia mazoezi ya vitendo katika lugha yako ya programu unayopendelea. Kila hatua inajumuisha maelezo wazi, mifano ya vitendo, na moyo wa kuhamasisha njiani. Ukimaliza safari hii, utakuwa na ujasiri wa kujenga seva zako za MCP, kuzingaia na majukwaa maarufu ya AI, na kuelewa jinsi teknolojia hii inavyoibadilisha mustakabali wa maendeleo ya AI. Twende pamoja katika adventure hii ya kufurahisha! ### Hati Rasmi na Maelezo ya Maelekezo Mtaala huu unaendana na **Maelezo ya MCP 2025-11-25** (toleo thabiti la hivi karibuni). Maelezo ya MCP hutumia utoaji toleo kwa tarehe (muundo wa YYYY-MM-DD) kuhakikisha ufuatiliaji wa toleo la itifaki kwa uwazi. Rasilimali hizi zitakuwa na thamani zaidi kadri unaelewa, lakini usijisikie kulazimika kusoma kila kitu mara moja. Anza na maeneo yanayokuvutia zaidi! - 📘 [Hati ya MCP](https://modelcontextprotocol.io/) – Hii ni rasilimali yako ya kwenda kwa nyaraka za hatua kwa hatua na miongozo ya mtumiaji. Hati imeandikwa kwa kuzingatia waanzilishi, zikitoa mifano wazi unayoweza kufuatilia kwa kasi yako mwenyewe. - 📜 [Maelezo ya MCP](https://modelcontextprotocol.io/specification/2025-11-25) – Fikiria hii kama mwongozo wako kamili wa rejea. Unapoendelea kupitia mtaala, utagundua unarudi hapa kutafuta maelezo maalum na kuchunguza vipengele vya hali ya juu. - 📜 [Utoaji Toleo wa Maelezo ya MCP](https://modelcontextprotocol.io/specification/versioning) – Hii ina taarifa kuhusu historia ya utoaji toleo la itifaki na jinsi MCP inavyotumia utoaji toleo kwa tarehe (muundo wa YYYY-MM-DD). - 🧑‍💻 [Hifadhi ya MCP GitHub](https://github.com/modelcontextprotocol) – Hapa utapata SDK, zana, na mifano ya kanuni katika lugha mbalimbali za programu. Ni kama hazina ya mifano ya vitendo na vipengele tayari kutumia. - 🌐 [Jumuiya ya MCP](https://github.com/orgs/modelcontextprotocol/discussions) – Jiunge na wenzako wanaojifunza na watengenezaji wenye uzoefu kwenye mijadala kuhusu MCP. Ni jamii inayounga mkono ambapo maswali yanakaribishwa na maarifa yanashirikiwa kwa uhuru. ## Malengo ya Kujifunza Mwisho wa mtaala huu, utajisikia kujiamini na kushangilia uwezo wako mpya. Hivi ndivyo utakavyofanikiwa: • **Elewa misingi ya MCP**: Utafahamu ni nini Protocol ya Muktadha wa Mfano na kwa nini inabadilisha jinsi programu za AI zinavyoshirikiana, kwa kutumia mifano na analogies zinazofaa. • **Jenga seva yako ya kwanza ya MCP**: Utatengeneza seva ya MCP inayofanya kazi katika lugha yako ya programu unayopendelea, kuanzia mifano rahisi na kukuza ujuzi hatua kwa hatua. • **Unganisha mifano ya AI na zana halisi**: Utafahamu jinsi ya kuunganisha tofauti kati ya mifano ya AI na huduma halisi, ukitoa programu zako uwezo mpya mkubwa. • **Tekeleza hatua bora za usalama**: Uelewa jinsi ya kuweka utekelezaji wa MCP kuwa salama na kinga, kulinda programu zako na watumiaji wako. • **Tumia kwa kujiamini**: Utajua jinsi ya kuchukua miradi ya MCP kutoka maendeleo hadi utengenezaji, kwa mikakati ya utekelezaji ya vitendo inayofanya kazi ulimwenguni. • **Jiunge na jumuiya ya MCP**: Utakuwa sehemu ya jumuiya inayokua ya watengenezaji wanaounda mustakabali wa maendeleo ya programu za AI. ## Mandhari Muhimu ya Msingi Kabla hatujaingia kwenye mambo maalum ya MCP, hebu tuhakikishe unajisikia raha na baadhi ya dhana za msingi. Usijali kama haujui kikamilifu - tutaeleza kila kitu unachohitaji kuelewa huku tukipita! ### Kuelewa Itifaki (Msingi) Fikiria itifaki kama sheria za mazungumzo. Unapommuita rafiki, nyote mnajua kusema "habari" unapojibu, kuchukua zamu za kuzungumza, na kusema "kwaheri" unapoisha. Programu za kompyuta zinahitaji sheria kama hizo kuwasiliana kwa ufanisi. MCP ni itifaki - seti ya sheria zilizokubaliwa ambazo husaidia mifano ya AI na programu kuwa na "mazungumzo" yenye tija na zana na huduma. Kama vile sheria za mazungumzo zinavyorahisisha mawasiliano ya binadamu, MCP hupunguza dosari na huongeza nguvu za mawasiliano ya programu za AI. ### Mahusiano ya Mteja-Seva (Jinsi Programu Zinavyoshirikiana) Tayari unatumia mahusiano ya mteja-seva kila siku! Unapotumia kivinjari (mteja) kutembelea tovuti, unakuja kwa seva ya wavuti inayokutumia ukurasa. Kivinjari kinajua kuulizia taarifa, na seva inajua jinsi ya kujibu. Katika MCP, tuna uhusiano kama huo: mifano ya AI hutenda kama wateja wanaoomba taarifa au vitendo, wakati seva za MCP hutoa uwezo huo. Ni kama kuwa na msaidizi mzuri (seva) ambaye AI inaweza kumuomba kutekeleza kazi maalum. ### Kwa Nini Kuwa na Viwango ni Muhimu (Kufanya Mambo Yaende Kwa Pamoja) Fikiria kama kila mtengenezaji wa gari atatumia pampu za mafuta yenye umbo tofauti - ungehitaji kiunganishi tofauti kwa kila gari! Viwango ni makubaliano ya njia za kawaida ili mambo yafanye kazi pamoja bila shida. MCP hutoa viwango hivi kwa programu za AI. Badala ya kila mfano wa AI kuhitaji msimbo maalum kuendana na kila zana, MCP huunda njia ya ulimwengu kwa wao kuwasiliana. Hii inamaanisha watengenezaji wanaweza kujenga zana mara moja na zifanye kazi na mifumo mingi ya AI. ## 🧭 Muhtasari wa Njia Yako ya Kujifunza Safari yako ya MCP imepangwa kwa ustadi kujenga ujasiri na ujuzi wako kwa hatua. Kila awamu inatambulisha dhana mpya huku ikithibitisha yale uliyoyajifunza. ### 🌱 Awamu ya Msingi: Kuelewa Misingi (Moduli 0-2) Hapa ndipo adventure yako inaanza! Tutakuonyesha dhana za MCP kwa kutumia analogies zinazojulikana na mifano rahisi. Utatambua ni nini MCP, kwa nini ipo, na jinsi inavyohusiana na dunia pana ya maendeleo ya AI. • **Moduli 0 - Utangulizi wa MCP**: Tutaanza kwa kuchunguza ni nini MCP na kwa nini ni muhimu kwa programu za AI za kisasa. Utaona mifano halisi ya MCP ikifanya kazi na kuelewa jinsi inavyotatua matatizo ya kawaida yanayokumba watengenezaji. • **Moduli 1 - Maelezo ya Misingi**: Hapa utajifunza vipengele muhimu vya MCP. Tutatumia analogies nyingi na mifano ya kuona kuhakikisha dhana hizi zinahisi za asili na kueleweka. • **Moduli 2 - Usalama katika MCP**: Usalama unaweza kuonekana kama kitu kigumu, lakini tutakuonesha jinsi MCP inavyojumuisha vipengele vya usalama vilivyojengwa ndani na kukuonyesha mbinu bora zinazolinda programu zako tangu mwanzo. ### 🔨 Awamu ya Ujenzi: Kutengeneza Utekelezaji Wako wa Kwanza (Moduli 3) Sasa furaha halisi inaanza! Utapata uzoefu wa vitendo wa kujenga seva na wateja halisi wa MCP. Usijali - tutaanzia rahisi na kukuongoza hatua kwa hatua. Moduli hii ina miongozo mingi ya vitendo inayokuwezesha kufanya mazoezi kwa lugha ya programu unayopendelea. Utaanzisha seva yako ya kwanza, ujenge mteja wa kuungana nayo, na hata kuunganisha na zana maarufu za maendeleo kama VS Code. Kila mwongozo una mifano kamili ya msimbo, vidokezo vya kutatua matatizo, na maelezo ya kwa nini tunachagua mbinu fulani za muundo. Mwishoni mwa hatua hii, utakuwa na utekelezaji wa MCP unaofanya kazi ambao unaweza kujivunia! ### 🚀 Awamu ya Ukuaji: Mawazo ya Juu na Matumizi Halisi (Moduli 4-5) Baada ya kupata msingi, uko tayari kuchunguza vipengele vya juu vya MCP. Tutajadili mikakati ya utekelezaji wa vitendo, mbinu za kutatua makosa, na mada za hali ya juu kama ujumuishaji wa AI wa aina mbalimbali. Pia utajifunza jinsi ya kupanua utekelezaji wako wa MCP kwa matumizi ya uzalishaji na kuunganishwa na mihimili ya wingu kama Azure. Moduli hizi zinakuandaa kujenga suluhisho za MCP zinazoweza kushughulikia mahitaji halisi ya dunia. ### 🌟 Awamu ya Ustadi: Jumuiya na Utaalamu (Moduli 6-11) Awamu ya mwisho inalenga kujiunga na jumuiya ya MCP na kuhitimu katika maeneo unayoyapenda zaidi. Utajifunza jinsi ya kuchangia miradi ya MCP ya chanzo wazi, kutekeleza mifumo ya uthibitishaji ya hali ya juu, na kujenga suluhisho kamili zinazojumuisha hifadhidata. Moduli 11 inastahili kutajwa maalum - ni njia kamili ya maabara 13 ya kujifunza kwa vitendo inayokufundisha kujenga seva za MCP tayari kwa uzalishaji zinazounganishwa na PostgreSQL. Ni kama mradi wa mwisho unaounganisha yote uliyoyajifunza! ### 📚 Muundo Kamili wa Mtaala | Moduli | Mada | Maelezo | Kiungo | |--------|-------|-------------|------| | **Moduli 0-3: Misingi** | | | | | 00 | Utangulizi wa MCP | Muhtasari wa Itifaki ya Muktadha wa Mfano na umuhimu wake katika mifereji ya AI | [Soma zaidi](./00-Introduction/README.md) | | 01 | Maelezo ya Dhahiri ya Misingi | Uchunguzi wa kina wa dhana kuu za MCP | [Soma zaidi](./01-CoreConcepts/README.md) | | 02 | Usalama katika MCP | Vitisho vya usalama na mbinu bora | [Soma zaidi](./02-Security/README.md) | | 03 | Kuanzisha na MCP | Usanidi wa mazingira, seva/mteja wa msingi, ujumuishaji | [Soma zaidi](./03-GettingStarted/README.md) | | **Moduli 3: Kujenga Seva Yako ya Kwanza & Mteja** | | | | | 3.1 | Seva ya Kwanza | Tengeneza seva yako ya kwanza ya MCP | [Mwongozo](./03-GettingStarted/01-first-server/README.md) | | 3.2 | Mteja wa Kwanza | Tengeneza mteja wa msingi wa MCP | [Mwongozo](./03-GettingStarted/02-client/README.md) | | 3.3 | Mteja na LLM | Jumuisha mifano mikubwa ya lugha | [Mwongozo](./03-GettingStarted/03-llm-client/README.md) | | 3.4 | Ujumuishaji wa VS Code | Tumia seva za MCP ndani ya VS Code | [Mwongozo](./03-GettingStarted/04-vscode/README.md) | | 3.5 | Seva ya stdio | Tengeneza seva kwa kutumia usafirishaji wa stdio | [Mwongozo](./03-GettingStarted/05-stdio-server/README.md) | | 3.6 | Utoaji wa HTTP | Tekeleza utoaji wa HTTP katika MCP | [Mwongozo](./03-GettingStarted/06-http-streaming/README.md) | | 3.7 | Microsoft Foundry Toolkit | Tumia Microsoft Foundry Toolkit na MCP | [Mwongozo](./03-GettingStarted/07-aitk/README.md) | | 3.8 | Upimaji | Jaribu utekelezaji wako wa seva ya MCP | [Mwongozo](./03-GettingStarted/08-testing/README.md) | | 3.9 | Uwekaji Kazi | Weka seva za MCP kwa uzalishaji | [Mwongozo](./03-GettingStarted/09-deployment/README.md) | | 3.10 | Matumizi ya seva ya juu | Tumia seva za hali ya juu kwa matumizi ya vipengele vya hali ya juu na usanifu ulioboreshwa | [Mwongozo](./03-GettingStarted/10-advanced/README.md) | | 3.11 | Uthibitishaji rahisi | Sura inayoelezea uthibitishaji tangu mwanzo na RBAC | [Mwongozo](./03-GettingStarted/11-simple-auth/README.md) | | 3.12 | Mabina MCP | Sanidi Claude Desktop, Cursor, Cline, na mabina mengine ya MCP | [Mwongozo](./03-GettingStarted/12-mcp-hosts/README.md) | | 3.13 | Mdanganyifu wa MCP | Tatua na jaribu seva za MCP kwa zana ya Inspector | [Mwongozo](./03-GettingStarted/13-mcp-inspector/README.md) | | 3.14 | Sampuli | Tumia sampuli kushirikiana na mteja | [Mwongozo](./03-GettingStarted/14-sampling/README.md) | | 3.15 | Programu za MCP | Jenga Programu za MCP | [Mwongozo](./03-GettingStarted/15-mcp-apps/README.md) | | **Moduli 4-5: Vitendo & Hali ya Juu** | | | | | 04 | Utekelezaji wa Vitendo | SDK, kutatua makosa, upimaji, templeti za maagizo zinazotumika tena | [Soma zaidi](./04-PracticalImplementation/README.md) | | 4.1 | Ukurasa | Shughulikia seti kubwa za matokeo kwa ukurasa unaotegemea cursor | [Mwongozo](./04-PracticalImplementation/pagination/README.md) | | 05 | Mada za Juu katika MCP | AI ya aina mbalimbali, upanuzi, matumizi ya biashara | [Soma zaidi](./05-AdvancedTopics/README.md) | | 5.1 | Ujumuishaji wa Azure | Ujumuishaji wa MCP na Azure | [Mwongozo](./05-AdvancedTopics/mcp-integration/README.md) | | 5.2 | Uainishaji wa Aina Nyingi | Kufanya kazi na aina nyingi | [Mwongozo](./05-AdvancedTopics/mcp-multi-modality/README.md) | | 5.3 | Onyesho la OAuth2 | Tekeleza uthibitishaji wa OAuth2 | [Mwongozo](./05-AdvancedTopics/mcp-oauth2-demo/README.md) | | 5.4 | Muktadha wa Msingi | Elewa na tekeleza muktadha wa mizizi | [Mwongozo](./05-AdvancedTopics/mcp-root-contexts/README.md) | | 5.5 | Utumaji | Mikakati ya utumaji wa MCP | [Mwongozo](./05-AdvancedTopics/mcp-routing/README.md) | | 5.6 | Sampuli | Mbinu za sampuli katika MCP | [Mwongozo](./05-AdvancedTopics/mcp-sampling/README.md) | | 5.7 | Upanuzi | Panua utekelezaji wa MCP | [Mwongozo](./05-AdvancedTopics/mcp-scaling/README.md) | | 5.8 | Usalama | Mambo ya juu ya usalama | [Mwongozo](./05-AdvancedTopics/mcp-security/README.md) | | 5.9 | Utafutaji wa Wavuti | Tekeleza uwezo wa utaftaji wa wavuti | [Mwongozo](./05-AdvancedTopics/web-search-mcp/README.md) | | 5.10 | Utoaji wa Moja kwa Moja | Jenga utendaji wa utoaji wa moja kwa moja | [Mwongozo](./05-AdvancedTopics/mcp-realtimestreaming/README.md) | | 5.11 | Utafutaji wa Moja kwa Moja | Tekeleza utafutaji wa moja kwa moja | [Mwongozo](./05-AdvancedTopics/mcp-realtimesearch/README.md) | | 5.12 | Uthibitishaji wa Entra ID | Uthibitishaji na Microsoft Entra ID | [Mwongozo](./05-AdvancedTopics/mcp-security-entra/README.md) | | 5.13 | Ujumuishaji wa Foundry | Unganisha na Microsoft Foundry | [Mwongozo](./05-AdvancedTopics/mcp-foundry-agent-integration/README.md) | | 5.14 | Uhandisi wa Muktadha | Mbinu za uhandisi wa muktadha mzuri | [Mwongozo](./05-AdvancedTopics/mcp-contextengineering/README.md) | | 5.15 | Usafirishaji Maalum wa MCP | Utekelezaji wa usafirishaji maalum | [Mwongozo](./05-AdvancedTopics/mcp-transport/README.md) | | 5.16 | Vipengele vya Itifaki | Arifa za maendeleo, kughairi, templeti za rasilimali | [Mwongozo](./05-AdvancedTopics/mcp-protocol-features/README.md) | | 5.17 | Uwekaji Hoji za Mawakala Wawili | Mawakala wawili wanapingana kwa kutumia zana za MCP za pamoja, yanapimwa na wakala wa hakimu | [Mwongozo](./05-AdvancedTopics/mcp-adversarial-agents/README.md) | | **Moduli 6-10: Jumuiya & Mbinu Bora** | | | | | 06 | Michango ya Jumuiya | Jinsi ya kuchangia ekosistimu ya MCP | [Mwongozo](./06-CommunityContributions/README.md) | | 07 | Mafunzo kutoka kwa Matumizi ya Awali | Hadithi za utekelezaji halisi | [Mwongozo](./07-LessonsfromEarlyAdoption/README.md) | | 08 | Mbinu Bora kwa MCP | Utendaji, uvumilivu wa makosa, uimara | [Mwongozo](./08-BestPractices/README.md) | | 09 | Masomo ya Kesi za MCP | Mifano ya utekelezaji wa vitendo | [Mwongozo](./09-CaseStudy/README.md) | | 10 | Warsha ya Vitendo | Kujenga Seva ya MCP na Microsoft Foundry Toolkit | [Laboratori](./10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/README.md) | | **Moduli 11: Maabara ya Vitendo ya Seva ya MCP** | | | | | 11 | Ujumuishaji wa Hifadhidata ya Seva ya MCP | Njia ya maabara 13 za kina ya kujifunza kwa vitendo za ujumuishaji wa PostgreSQL | [Maabara](./11-MCPServerHandsOnLabs/README.md) | | 11.1 | Utangulizi | Muhtasari wa MCP na ujumuishaji wa hifadhidata na kesi ya uchambuzi wa rejareja | [Lab 00](./11-MCPServerHandsOnLabs/00-Introduction/README.md) | | 11.2 | Usanifu wa Msingi | Kuelewa usanifu wa seva ya MCP, tabaka za hifadhidata, na mifumo ya usalama | [Lab 01](./11-MCPServerHandsOnLabs/01-Architecture/README.md) | | 11.3 | Usalama & Upatikanaji wa Waajiri Wengi | Usalama wa Kiwango cha Mstari, uthibitishaji, na upatikanaji wa data wa waajiri wengi | [Lab 02](./11-MCPServerHandsOnLabs/02-Security/README.md) | | 11.4 | Usanidi wa Mazingira | Kuanzisha mazingira ya maendeleo, Docker, rasilimali za Azure | [Lab 03](./11-MCPServerHandsOnLabs/03-Setup/README.md) | | 11.5 | Ubunifu wa Hifadhidata | Usanidi wa PostgreSQL, muundo wa rejareja wa muktadha, na sampuli za data | [Lab 04](./11-MCPServerHandsOnLabs/04-Database/README.md) | | 11.6 | Utekelezaji wa Seva ya MCP | Kujenga seva ya FastMCP yenye ujumuishaji wa hifadhidata | [Lab 05](./11-MCPServerHandsOnLabs/05-MCP-Server/README.md) | | 11.7 | Maendeleo ya Zana | Kutengeneza zana za kuulizia hifadhidata na uchunguzi wa muktadha | [Lab 06](./11-MCPServerHandsOnLabs/06-Tools/README.md) | | 11.8 | Utafutaji wa Kimaana | Kutekeleza embeddings za vector na Azure OpenAI na pgvector | [Lab 07](./11-MCPServerHandsOnLabs/07-Semantic-Search/README.md) | | 11.9 | Upimaji & Utatuzi wa Makosa | Mikakati ya upimaji, zana za utatuzi wa makosa, na mbinu za uthibitishaji | [Lab 08](./11-MCPServerHandsOnLabs/08-Testing/README.md) | | 11.10 | Ujumuishaji wa VS Code | Kusanidi ujumuishaji wa VS Code MCP na matumizi ya AI Chat | [Lab 09](./11-MCPServerHandsOnLabs/09-VS-Code/README.md) | | 11.11 | Mikakati ya Uwekaji Kazi | Uwekaji kazi wa Docker, Azure Container Apps, na mazingira ya upanuzi | [Lab 10](./11-MCPServerHandsOnLabs/10-Deployment/README.md) | | 11.12 | Ufuatiliaji | Application Insights, kurekodi, ufuatiliaji wa utendaji | [Lab 11](./11-MCPServerHandsOnLabs/11-Monitoring/README.md) | | 11.13 | Mbinu Bora | Uboreshaji wa utendaji, kuimarisha usalama, na vidokezo vya uzalishaji | [Lab 12](./11-MCPServerHandsOnLabs/12-Best-Practices/README.md) | | **Moduli 12: Zana za MCP** | | | | | 12.1 | Zana | Matumizi ya MCP katika Programu ya Copilot | [ Mwongozo ](./12-tooling/README.md) | ### 💻 Miradi ya Mifano ya Msimbo Mojawapo ya sehemu za kusisimua za kujifunza MCP ni kuona ustadi wako wa msimbo ukikua hatua kwa hatua. Tumeandaa mifano yetu kwa kuanzia rahisi na kuendelea kuwa ngumu zaidi kadri uelewa wako unavyoongezeka. Hapa ndipo tunavyoanzisha dhana – na msimbo unaoeleweka bila tatizo lakini unaonyesha kanuni halisi za MCP, utaelewa si tu kile msimbo huu unafanya, bali kwa nini umeundwa hivi na jinsi unavyolingana na programu kubwa za MCP. #### Sampuli za Kimsingi za Kihesabu MCP | Lugha | Maelezo | Kiungo | |----------|-------------|------| | C# | Mfano wa Seva ya MCP | [Tazama Msimbo](./03-GettingStarted/samples/csharp/README.md) | | Java | Kihesabu MCP | [Tazama Msimbo](./03-GettingStarted/samples/java/calculator/README.md) | | JavaScript | Onyesho la MCP | [Tazama Msimbo](./03-GettingStarted/samples/javascript/README.md) | | Python | Seva ya MCP | [Tazama Msimbo](../../03-GettingStarted/samples/python/mcp_calculator_server.py) | | TypeScript | Mfano wa MCP | [Tazama Msimbo](./03-GettingStarted/samples/typescript/README.md) | | Rust | Mfano wa MCP | [Tazama Msimbo](./03-GettingStarted/samples/rust/README.md) | #### Utekelezaji wa Juu wa MCP | Lugha | Maelezo | Kiungo | |----------|-------------|------| | C# | Sampuli ya Juu | [Tazama Msimbo](./04-PracticalImplementation/samples/csharp/README.md) | | Java na Spring | Mfano wa Programu ya Kontena | [Tazama Msimbo](./04-PracticalImplementation/samples/java/containerapp/README.md) | | JavaScript | Mfano wa Juu zaidi | [Tazama Msimbo](./04-PracticalImplementation/samples/javascript/README.md) | | Python | Utekelezaji Mgumu | [Tazama Msimbo](./04-PracticalImplementation/samples/python/README.md) | | TypeScript | Mfano wa Kontena | [Tazama Msimbo](./04-PracticalImplementation/samples/typescript/README.md) | ## 🎯 Masharti ya Kujiandaa kwa Kujifunza MCP Ili kupata faida zaidi kutoka kwa mtaala huu, unapaswa kuwa na: - Ujuzi wa msingi wa programu kwa 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) Historia katika dhana za AI/ML - Kushiriki mijadala ya jamii yetu kwa msaada ## 📚 Mwongozo wa Kusoma na Rasilimali Hifadhi hii ina rasilimali kadhaa za kukusaidia kuvinjari na kujifunza kwa ufanisi: ### Mwongozo wa Kusoma Mwongozo kamili wa [Kusoma](./study_guide.md) upo kusaidia kuvinjari hifadhi hii kwa ufanisi. Ramani hii ya mtaala wa kuona inaonyesha jinsi mada zote zinavyohusiana na hutoa mwelekezo juu ya jinsi ya kutumia miradi ya mfano kwa ufanisi. Ni msaada hasa kwa wale wanaojifunza kwa kuona picha kubwa. Mwongozo unajumuisha: - Ramani ya mtaala wa kuona inayoonyesha mada zote zilizofunikwa - Ugawaji wa kina wa kila sehemu ya hifadhi - Mwongozo juu ya jinsi ya kutumia miradi ya mfano - Njia za kujifunza zinazopendekezwa kwa viwango tofauti vya ujuzi - Rasilimali za ziada za kuimarisha safari yako ya kujifunza ### Mabadiliko Tunazika rekodi ya kina ya [Mabadiliko](./changelog.md) inayofuatilia masasisho yote muhimu ya vifaa vya mtaala, ili uweze kubaki na taarifa mpya kuhusu maboresho na kuongeza. - Maudhui mapya yaliyoongezwa - Mabadiliko ya muundo - Maboresho ya vipengele - Maboresho ya nyaraka ## 🛠️ Jinsi ya Kutumia Mtaala Huu kwa Ufanisi Kila somo katika mwongozo huu linajumuisha: 1. Maelezo wazi ya dhana za MCP 2. Mifano hai ya msimbo katika lugha mbalimbali 3. Mazoezi ya kujenga programu halisi za MCP 4. Rasilimali za ziada kwa wanaojifunza kwa kina ### Tujifunze MCP na C# - Mfululizo wa Mafunzo Tujifunze kuhusu Model Context Protocol (MCP), mfumo wa kisasa uliotengenezwa kusanifisha mwingiliano kati ya mifano ya AI na programu za mteja. Kupitia kikao hiki cha kuanzia kirafiki, tutakuingiza katika MCP na kukuongoza kuunda seva yako ya kwanza ya MCP. #### C#: [https://aka.ms/letslearnmcp-csharp](https://aka.ms/letslearnmcp-csharp) #### Java: [https://aka.ms/letslearnmcp-java](https://aka.ms/letslearnmcp-java) #### JavaScript: [https://aka.ms/letslearnmcp-javascript](https://aka.ms/letslearnmcp-javascript) #### Python: [https://aka.ms/letslearnmcp-python](https://aka.ms/letslearnmcp-python) ## 🎓 Safari Yako ya MCP Ina Anza Hongera! Umefanya hatua ya kwanza katika safari ya kusisimua ambayo itaongeza uwezo wako wa programu na kukuunganisha na teknolojia ya kisasa ya maendeleo ya AI. ### Ulivyo Tayari Kufanikisha Kwa kusoma utangulizi huu, tayari umeanza kujenga msingi wa maarifa ya MCP. Unaelewa ni nini MCP, kwa nini ni muhimu, na jinsi mtaala huu utakavyosaidia safari yako ya kujifunza. Hiyo ni mafanikio makubwa na mwanzo wa utaalamu wako katika teknolojia hii muhimu. ### Safari Inayoendelea Unapoendelea kupitia moduli, kumbuka kwamba kila mtaalamu alikuwa mwanzoni mwanzo. Dhana ambazo zinaweza kuonekana ngumu sasa zitakuwa rahisi unapozoea na kuzitumia. Kila hatua ndogo hujenga uwezo mkubwa utakaokutumikia katika taaluma yako ya maendeleo. ### Mtandao wa Msaada Wako Unaungana na jumuiya ya wanaojifunza na wataalamu wanaopenda MCP na wana hamu ya kusaidia wengine kufanikiwa. Ikiwa umekwama katika changamoto ya program, au unafurahia kushiriki mafanikio, jamii iko hapa kusaidia safari yako. Kama unakwama au una maswali kuhusu ujenzi wa programu za AI. Jiunge na wanaojifunza wenzako na watengenezaji wenye uzoefu katika mijadala kuhusu MCP. Ni jamii yenye msaada ambapo maswali yanakaribishwa na maarifa hushirikiwa kwa uhuru. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) Ikiwa una maoni kuhusu bidhaa au makosa wakati wa kujenga tembelea: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) ### Tayari Kuanzia? Safari yako ya MCP inaanza sasa! Anza na Moduli 0 ili kujifunza uzoefu wako wa kwanza wa mikono katika MCP, au chunguza miradi ya mfano kuona unachojenga. Kumbuka - kila mtaalamu alianza hasa pale ulipo sasa, na kwa uvumilivu na mazoezi, utashangazwa na kile unachoweza kufanikisha. Karibu duniani ya maendeleo ya Model Context Protocol. Hebu tujenge kitu cha kushangaza pamoja! ## 🤝 Kuchangia Jamii ya Kujifunza Mtaala huu unakua kwa nguvu kwa michango kutoka kwa wanaojifunza kama wewe! Iwe unarekebisha tahajia, kupendekeza maelezo ya wazi zaidi, au kuongeza mfano mpya, michango yako husaidia wanaoanza wengine kufanikisha. Shukrani kwa Microsoft Valued Professional [Shivam Goyal](https://www.linkedin.com/in/shivam2003/) kwa kuchangia mifano ya msimbo. Mchakato wa mchango umeundwa kuwa wa kukaribisha na kuunga mkono. Michango mingi inahitaji Makubaliano ya Leseni ya Mchango (CLA), lakini zana za kiotomatiki zitakuongoza hatua kwa hatua kwa urahisi. ## 📜 Kujifunza Chanzo Huria Mtaala huu mzima upo chini ya leseni ya MIT [LICENSE](../../LICENSE), ikimaanisha unaweza kutumia, kubadilisha, na kusambaza bure. Hii inaunga mkono dhamira yetu ya kufanya maarifa ya MCP kupatikana kwa watengenezaji kote duniani. ## 🤝 Miongozo ya Michango Mradi huu unakaribisha michango na mapendekezo. Michango mingi inahitaji ukubali wa Makubaliano ya Leseni ya Mchango (CLA) inayotangaza kuwa una haki, na kwa kweli unatoa, haki za kutumia mchango wako. Kwa maelezo, tembelea . Unapowasilisha ombi la pull request, bot wa CLA ataamua moja kwa moja kama unahitaji kutoa CLA na kuandaa PR ipasavyo (mfano, ukaguzi wa hali, maoni). Fuata tu maagizo iliyotolewa na bot. Hii utaitoa mara moja tu katika hifadhi zote zinazotumia CLA yetu. Mradi huu umechukua [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). Kwa maelezo zaidi tazama [Maswali ya Jumla kuhusu Kanuni za Maadili](https://opensource.microsoft.com/codeofconduct/faq/) au wasiliana na [opencode@microsoft.com](mailto:opencode@microsoft.com) kwa maswali au maoni zaidi. --- * Tayari kuanza safari yako ya MCP? Anza na [Moduli 00 - Utangulizi wa MCP](./00-Introduction/README.md) na chukua hatua zako za kwanza katika ulimwengu wa maendeleo ya Model Context Protocol! * ## 🎒 Kozi Nyingine Timu yetu huandaa kozi nyingine! Angalia: ### LangChain [![LangChain4j kwa Waanzilishi](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) [![LangChain.js kwa Waanzilishi](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) [![LangChain kwa Waanzilishi](https://img.shields.io/badge/LangChain%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://github.com/microsoft/langchain-for-beginners?WT.mc_id=m365-94501-dwahlin) --- ### Azure / Edge / MCP / Wakala [![AZD kwa Waanzilishi](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) [![Edge AI kwa Waanzilishi](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) [![MCP kwa Waanzilishi](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) [![Wakala wa AI kwa Waanzilishi](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- ### Mfululizo wa AI Inayotengeneza [![AI Inayotengeneza kwa Waanzilishi](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) [![AI Inayotengeneza (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) [![AI Inayotengeneza (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) [![AI Inayotengeneza (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- ### Kujifunza Msingi [![ML kwa Waanzilishi](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) [![Sayansi ya Takwimu kwa Waanzilishi](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![AI kwa Waanzilishi](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![Usalama wa Mtandao kwa Waanzilishi](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) [![Uendelezaji wa Wavuti kwa Waanzilishi](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) [![IoT kwa Waanzilishi](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) [![Maendeleo ya XR kwa Waanzilishi](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- ### Mfululizo wa Copilot [![Copilot kwa Programu ya Pande Mbili ya AI](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) [![Copilot kwa C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) [![Ushindani wa Copilot](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) --- **Kionyozo**: Hati hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI [Co-op Translator](https://github.com/Azure/co-op-translator). Ingawa tunajitahidi kupata usahihi, tafadhali fahamu kwamba tafsiri za kiotomatiki zinaweza kuwa na makosa au upungufu wa usahihi. Hati ya asili katika lugha yake halisi inapaswa kuchukuliwa kama chanzo cha mamlaka. Kwa taarifa muhimu, tafsiri ya kitaalamu inayofanywa na binadamu inapendekezwa. Hatutojibu kwa kuelewa vibaya au tafsiri potofu zinazotokea kutokana na matumizi ya tafsiri hii.