Mwongozo huu wa kujifunza unatoa muhtasari wa muundo na yaliyomo kwenye hazina ya "Model Context Protocol (MCP) for Beginners". Tumia mwongozo huu kuvinjari hazina kwa ufanisi na kufaidika zaidi na rasilimali zilizopo.
Model Context Protocol (MCP) ni mfumo uliosanifiwa kwa maingiliano kati ya mifano ya AI na programu za wateja. Asili ilizaliwa na Anthropic, MCP sasa inasimamiwa na jamii pana ya MCP kupitia shirika rasmi la GitHub. Hazina hii hutoa mtaala mpana wenye mifano ya vitendo ya nambari katika C#, Java, JavaScript, Python, na TypeScript, iliyoundwa kwa waendelezaji wa AI, wahandisi wa mifumo, na wahandisi wa programu.
mindmap
root((MCP kwa Waanzilishi))
00. Utangulizi
::icon(fa fa-book)
(Muhtasari wa Itifaki)
(Manufaa ya Kuanzisha Viwango)
(Matumizi halisi duniani)
(Misingi ya Uingizaji AI)
01. Misingi Mikuu
::icon(fa fa-puzzle-piece)
(Miundo ya Mteja-Mtumiaji)
(Vipengele vya Itifaki)
(Mifumo ya Ujumbe)
(Vifaa vya Usafirishaji)
(Majukumu - Jaribio)
(Maelezo ya Zana)
02. Usalama
::icon(fa fa-shield)
(Vitisho vya AI Maalum)
(Mbinu Bora za 2025)
(Usalama wa Maudhui wa Azure)
(Uthibitishaji & Ruhusa)
(Taarifa za Ulinzi za Microsoft)
(OWASP MCP Top 10)
(Warsha ya Usalama Sherpa)
03. Kuanzia
::icon(fa fa-rocket)
(Utekelezaji wa Kwanza wa Server)
(Maendeleo ya Mteja)
(Uingizaji wa Mteja LLM)
(Virutubisho vya VS Code)
(Usanidi wa Server SSE)
(Utiririshaji wa HTTP)
(Uingizaji wa Zana za AI)
(Mifumo ya Upimaji)
(Matumizi ya Juu ya Server)
(Uthibitishaji Rahisi)
(Mikakati ya Uenezi)
(Usanidi wa MCP Hosts)
(Mkaguzi wa MCP)
04. Utekelezaji wa Vitendo
::icon(fa fa-code)
(SDK nyingi za Lugha)
(Upimaji & Urekebishaji)
(Mifano ya Prompt)
(Miradi ya Mfano)
(Mifumo ya Uzalishaji)
(Mikakati ya Kurasa)
05. Mada za Juu
::icon(fa fa-graduation-cap)
(Uhandisi wa Muktadha)
(Uingizaji wa Wakala wa Foundry)
(Mifumo ya AI yenye Modal nyingi)
(Uthibitishaji wa OAuth2)
(Utafutaji wa Muda Halisi)
(Itifaki za Utiririshaji)
(Muktadha wa Mizizi)
(Mikakati ya Routing)
(Mbinu za Kumasanya Sampuli)
(Suluhisho za Kupanua)
(Kukaza Usalama)
(Uingizaji wa Entra ID)
(Utafutaji wa Wavuti MCP)
(Uchambuzi wa Kipengele cha Itifaki)
06. Jamii
::icon(fa fa-users)
(Michango ya Msimbo)
(Nyaraka)
(Ecosystem ya Mteja MCP)
(Rejista ya Server MCP)
(Zana za Kizazi cha Picha)
(Mshikamano wa GitHub)
07. Matumizi ya Mapema
::icon(fa fa-lightbulb)
(Uenezi wa Uzalishaji)
(Server za Microsoft MCP)
(Huduma ya Azure MCP)
(Somo za Kesi za Biashara)
(Ramani ya Mitaa ya Baadaye)
08. Mbinu Bora
::icon(fa fa-check)
(Uboreshaji wa Utendaji)
(Uvumilivu wa Hitilafu)
(Kustahimili Mfumo)
(Ufuatiliaji & Uwekaji wa Macho)
09. Masomo ya Kesi
::icon(fa fa-file-text)
(Usimamizi wa API ya Azure)
(Mwakilishi wa Kusafiri wa AI)
(Uingizaji wa Azure DevOps)
(Nyaraka MCP)
(Rejista ya MCP GitHub)
(Uingizaji wa VS Code)
(Utekelezaji halisi duniani)
10. Warsha ya Vitendo
::icon(fa fa-laptop)
(Misingi ya Server MCP)
(Maendeleo ya Juu)
(Uingizaji wa Zana za AI)
(Uenezi wa Uzalishaji)
(Muundo wa Maabara 4)
11. Maabara ya Uingizaji wa Hifadhidata
::icon(fa fa-database)
(Uingizaji wa PostgreSQL)
(Matumizi ya Uchanganuzi wa Rejareja)
(Usalama wa Kiwango cha Safu)
(Utafutaji wa Semantiki)
(Uenezi wa Uzalishaji)
(Muundo wa Maabara 13)
(Mafunzo ya Vitendo)
Hazina imepangwa katika sehemu kumi na moja kuu, kila moja ikilenga nyanja tofauti za MCP:
-
Utangulizi (00-Introduction/)
- Muhtasari wa Itifaki ya Muktadha wa Mfano
- Kwa nini kusanifisha ni muhimu katika nyaya za AI
- Matumizi halisi na manufaa
-
Madharia Muhimu (01-CoreConcepts/)
- Miundo ya mteja-seva
- Vipengele muhimu vya itifaki
- Mifumo ya ujumbe ndani ya MCP
-
Usalama (02-Security/)
- Vitisho vya usalama katika mifumo ya MCP
- Mazoezi bora ya usalama katika utekelezaji
- Mikakati ya uthibitishaji na ruhusa
- Nyaraka Kamili za Usalama:
- Mazoezi Bora ya Usalama ya MCP 2025
- Mwongozo wa Utekelezaji wa Usalama wa Azure Content
- Udhibiti na Mbinu za Usalama za MCP
- Marejeleo ya Haraka ya Mazoezi Bora ya MCP
- Mada Muhimu za Usalama:
- Mashambulizi ya sindano za maelekezo na sumu za zana
- Uvujaji wa vikao na matatizo ya mbunifu aliyochanganyikiwa
- Udhaifu wa ufikiaji wa tokeni
- Uruhusa kupita kiasi na udhibiti wa upatikanaji
- Usalama wa mnyororo wa usambazaji wa vipengele vya AI
- Uunganishaji wa Microsoft Prompt Shields
-
Anza Kutumia (03-GettingStarted/)
- Usanidi wa mazingira na mipangilio
- Kuunda seva na wateja wa MCP wa msingi
- Uunganisho na programu zilizopo
- Inajumuisha sehemu za:
- Utekelezaji wa seva ya kwanza
- Maendeleo ya mteja
- Uunganisho wa mteja wa LLM
- Uunganisho wa VS Code
- Seva ya Matukio ya Server-Sent (SSE)
- Matumizi ya seva ya juu
- Upeperushaji wa HTTP
- Uunganisho wa AI Toolkit
- Mikakati ya majaribio
- Mwongozo wa usambazaji
-
Utekelezaji wa Kivitendo (04-PracticalImplementation/)
- Kutumia SDK katika lugha tofauti za programu
- Mbinu za kubaini hitilafu, kufanya majaribio, na kuthibitisha
- Kutengeneza templeti na mtiririko wa kazi unaoweza kutumika tena
- Miradi ya mfano na mifano ya utekelezaji
-
Mada za Juu (05-AdvancedTopics/)
- Mbinu za uhandisi wa muktadha
- Uunganisho wa wakala Foundry
- Mtiririko wa kazi wa AI wa aina nyingi
- Demo za uthibitishaji OAuth2
- Uwezo wa utafutaji wa papo hapo
- Upeperushaji wa papo hapo
- Utekelezaji wa muktadha mzizi
- Mikakati ya utumaji data
- Mbinu za sampuli
- Mbinu za upanaji
- Mambo ya usalama
- Uunganisho wa usalama wa Entra ID
- Uunganisho wa utafutaji wa wavuti
-
Michango ya Jumuiya (06-CommunityContributions/)
- Jinsi ya kuchangia nambari na nyaraka
- Ushirikiano kupitia GitHub
- Maboresho na maoni yanayotokana na jamii
- Kutumia wateja mbalimbali wa MCP (Claude Desktop, Cline, VSCode)
- Kufanya kazi na seva maarufu za MCP zikiwemo za usindikaji picha
-
Mafunzo kutoka kwa Matumizi ya Mapema (07-LessonsfromEarlyAdoption/)
- Utekelezaji wa ulimwengu halisi na hadithi za mafanikio
- Kujenga na kusambaza suluhisho za MCP
- Mwelekeo na ramani ya mustakabali
- Mwongozo wa Seva za Microsoft MCP: Mwongozo kamili wa seva 10 za MCP za Microsoft tayari kutoa huduma, zikiwemo:
- Seva ya Microsoft Learn Docs MCP
- Seva ya Azure MCP (viunganishi maalum 15+)
- Seva ya GitHub MCP
- Seva ya Azure DevOps MCP
- Seva ya MarkItDown MCP
- Seva ya SQL Server MCP
- Seva ya Playwright MCP
- Seva ya Dev Box MCP
- Seva ya Azure AI Foundry MCP
- Seva ya Microsoft 365 Agents Toolkit MCP
-
Mazoezi Bora (08-BestPractices/)
- Kusahihisha utendaji na kuboresha
- Kubuni mifumo ya MCP isiyovunjika
- Mikakati ya kujaribu na uimara
-
Somo za Kesi (09-CaseStudy/)
- Somo saba za kesi kamili zinazoonyesha utofauti wa MCP katika hali tofauti:
- Wakala wa Usafiri wa Azure AI: Usimamizi wa nguvu nyingi na Azure OpenAI na AI Search
- Uunganisho wa Azure DevOps: Kuendesha taratibu za mitiririko kazi kwa sasisho za data ya YouTube
- Uchapaji Hati wa Wakati Halisi: Mteja wa Python wa console na upeperushaji wa HTTP
- Kizalishaji cha Mpango wa Masomo wa Mshirikiano: Programu ya wavuti ya Chainlit yenye AI ya mazungumzo
- Nyaraka Zaidi ya Mhariri: Uunganisho wa VS Code na mitiririko ya kazi ya GitHub Copilot
- Usimamizi wa Azure API: Uunganisho wa API ya kampuni na uundaji seva ya MCP
- Sajili ya MCP ya GitHub: Maendeleo ya mazingira na jukwaa la uunganisho la wakala
- Mifano ya utekelezaji inayoanzia uunganisho wa kampuni, tija ya waendelezaji, na maendeleo ya mazingira
-
Warsha ya Vitendo (10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/)
- Warsha ya vitendo pana inayochanganya MCP na AI Toolkit
- Kujenga programu za akili zinazounganisha mifano ya AI na zana za dunia halisi
- Moduli za vitendo zinazojumuisha misingi, maendeleo ya seva maalum, na mikakati ya usambazaji wa uzalishaji
- Muundo wa Kiwanda:
- Kiwanda 1: Misingi ya Seva ya MCP
- Kiwanda 2: Maendeleo ya Sevabuya ya MCP
- Kiwanda 3: Uunganisho wa AI Toolkit
- Kiwanda 4: Usambazaji wa Uzalishaji na Upanuzi
- Njia ya kujifunza kwa vitendo yenye maelekezo hatua kwa hatua
-
Maabara za Uunganisho wa Hifadhidata za Seva ya MCP (11-MCPServerHandsOnLabs/)
- Njia ya kujifunza ya maabara 13 kamili ya kujenga seva za MCP tayari kuzalisha uzalishaji na uunganisho wa PostgreSQL
- Utekelezaji halisi wa uchambuzi wa rejareja kwa kutumia kesi ya matumizi ya Zava Retail
- Mifumo ya kiwango cha kampuni ikiwa ni pamoja na Usalama wa Kiwango cha Safu (RLS), utafutaji wa maana, na upatikanaji wa data wa wapangaji wengi
- Muundo Kamili wa Maabara:
- Maabara 00-03: Msingi - Utangulizi, Mimarisho, Usalama, Usanidi wa Mazingira
- Maabara 04-06: Ujenzi wa Seva ya MCP - Ubuni wa Hifadhidata, Utekelezaji wa Seva ya MCP, Uendelezaji wa Zana
- Maabara 07-09: Vipengele vya Juu - Utafutaji wa Maana, Majaribio & Uwagiliaji Hitilafu, Uunganisho wa VS Code
- Maabara 10-12: Uzalishaji & Mazoezi Bora - Usambazaji, Ufuatiliaji, Uboreshaji
- Teknolojia Zinazoshughulikiwa: Mfumo wa FastMCP, PostgreSQL, Azure OpenAI, Azure Container Apps, Application Insights
- Matokeo ya Kujifunza: seva za MCP tayari uzalishaji, mifumo ya uunganisho wa hifadhidata, uchambuzi unaoendeshwa na AI, usalama wa kampuni
Hazina ina rasilimali za kusaidia:
- Folda ya Picha: Inajumuisha michoro na maelezo yanayotumika katika mtaala mzima
- Tafsiri: Usaidizi wa lugha nyingi na tafsiri za moja kwa moja za nyaraka
- Rasilimali Rasmi za MCP:
- Kujifunza kwa Mfuatano: Fuata sura kwa mpangilio (00 hadi 11) kwa uzoefu wa kujifunza uliopangwa.
- Kuzingatia Lugha Fulani: Kama unavutiwa na lugha fulani ya programu, chunguza folda za mifano kwa utekelezaji katika lugha unayopendelea.
- Utekelezaji wa Kivitendo: Anza na sehemu ya "Getting Started" kusanidi mazingira yako na kuunda seva na mteja wako wa MCP wa kwanza.
- Uchunguzi wa Juu: Ukipata uelewa wa misingi, ingia katika mada za juu ili kupanua maarifa yako.
- Ushirikiano wa Jamii: Jiunge na jamii ya MCP kupitia majadiliano ya GitHub na channels za Discord kuungana na wataalamu na waendelezaji wenzako.
Mtaala unahusisha wateja na zana mbalimbali za MCP:
-
Wateja Rasmi:
- Visual Studio Code
- MCP katika Visual Studio Code
- Claude Desktop
- Claude katika VSCode
- Claude API
-
Wateja wa Jamii:
- Cline (kielekezi cha terminal)
- Cursor (mhariri wa nambari)
- ChatMCP
- Windsurf
-
Zana za Usimamizi wa MCP:
- MCP CLI
- MCP Manager
- MCP Linker
- MCP Router
Hazina inaanzisha seva mbalimbali za MCP, zikiwemo:
-
Seva Rasmi za Microsoft MCP:
- Seva ya Microsoft Learn Docs MCP
- Seva ya Azure MCP (viunganishi maalum 15+)
- Seva ya GitHub MCP
- Seva ya Azure DevOps MCP
- Seva ya MarkItDown MCP
- Seva ya SQL Server MCP
- Seva ya Playwright MCP
- Seva ya Dev Box MCP
- Seva ya Azure AI Foundry MCP
- Seva ya Microsoft 365 Agents Toolkit MCP
-
Seva za Marejeleo Rasmi:
- Filesystem
- Fetch
- Memory
- Sequential Thinking
-
Uundaji Picha:
- Azure OpenAI DALL-E 3
- Stable Diffusion WebUI
- Replicate
-
Zana za Maendeleo:
- Git MCP
- Terminal Control
- Code Assistant
-
Seva Maalum:
- Salesforce
- Microsoft Teams
- Jira & Confluence
Hazina hii inakaribisha michango kutoka kwa jamii. Angalia sehemu ya Michango ya Jamii kwa mwongozo wa jinsi ya kuchangia kwa ufanisi katika mazingira ya MCP.
Mwongozo huu wa kujifunza ulisasishwa mwisho tarehe 5 Februari 2026, ukiakisi Maelekezo ya MCP ya hivi karibuni 2025-11-25 na kutoa muhtasari wa hazina hadi tarehe hiyo. Yaliyomo katika hazina yanaweza kusasishwa baada ya tarehe hii.
Taarifa ya Kutolewa Hukumu: Hati hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI Co-op Translator. Ingawa tunajitahidi kuhakikisha usahihi, tafadhali fahamu kuwa tafsiri za moja kwa moja 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 ya binadamu inapendekezwa. Hatubebei jukumu kwa kutoelewana au tafsiri potofu zinazotokana na matumizi ya tafsiri hii.