Skip to content

Latest commit

 

History

History
272 lines (178 loc) · 12.7 KB

README.md

File metadata and controls

272 lines (178 loc) · 12.7 KB

Utekelezaji wa Kivitendo

Utekelezaji wa kivitendo ndiko ambapo nguvu ya Model Context Protocol (MCP) inakuwa dhahiri. Ingawa kuelewa nadharia na usanifu wa MCP ni muhimu, thamani halisi huibuka unapoweka dhana hizi katika matumizi kwa kujenga, kujaribu, na kupeleka suluhisho zinazotatua matatizo halisi ya dunia. Sura hii inaunganisha pengo kati ya maarifa ya dhana na maendeleo ya vitendo, ikikuongoza kupitia mchakato wa kuleta programu zinazotegemea MCP kuwa halisi.

Iwe unaunda wasaidizi wa akili, kuingiza AI katika michakato ya biashara, au kutengeneza zana maalum za usindikaji data, MCP hutoa msingi wenye kubadilika. Muundo wake usioegemea lugha yoyote na SDK rasmi kwa lugha maarufu za programu hufanya iwe rahisi kwa watengenezaji wengi. Kwa kutumia SDK hizi, unaweza haraka kuunda mifano, kurudia mchakato, na kupanua suluhisho zako kwenye majukwaa na mazingira tofauti.

Katika sehemu zinazofuata, utapata mifano ya vitendo, msimbo wa mfano, na mikakati ya upeleka inayothibitisha jinsi ya kutekeleza MCP katika C#, Java, TypeScript, JavaScript, na Python. Pia utajifunza jinsi ya kutatua matatizo na kujaribu seva zako za MCP, kusimamia API, na kupeleka suluhisho kwenye wingu kwa kutumia Azure. Rasilimali hizi za vitendo zimeundwa kukuza haraka ujifunzaji wako na kukusaidia kujenga kwa kujiamini programu thabiti za MCP zinazotumika uzalishaji.

Muhtasari

Somo hili linazingatia mambo ya vitendo ya utekelezaji wa MCP katika lugha mbalimbali za programu. Tutachunguza jinsi ya kutumia SDK za MCP katika C#, Java, TypeScript, JavaScript, na Python kujenga programu thabiti, kutatua matatizo na kujaribu seva za MCP, na kuunda rasilimali, maelekezo, na zana zinazoweza kutumika tena.

Malengo ya Kujifunza

Mwisho wa somo hili, utaweza:

  • Kutekeleza suluhisho za MCP kwa kutumia SDK rasmi katika lugha mbalimbali za programu
  • Kutatua matatizo na kujaribu seva za MCP kwa mfumo
  • Kuunda na kutumia vipengele vya seva (Rasilimali, Maelekezo, na Zana)
  • Kubuni michakato madhubuti ya MCP kwa kazi ngumu
  • Kuboresha utekelezaji wa MCP kwa utendaji na kuaminika

Rasilimali Rasmi za SDK

Model Context Protocol hutoa SDK rasmi kwa lugha nyingi:

Kufanya kazi na SDK za MCP

Sehemu hii inatoa mifano ya vitendo ya utekelezaji wa MCP katika lugha mbalimbali za programu. Unaweza kupata msimbo wa mfano katika saraka ya samples iliyopangwa kwa lugha.

Mifano Inayopatikana

Hifadhi ina mifano ya utekelezaji katika lugha zifuatazo:

Kila mfano unaonyesha dhana kuu za MCP na mifumo ya utekelezaji kwa lugha na mfumo husika.

Vipengele Vikuu vya Seva

Seva za MCP zinaweza kutekeleza mchanganyiko wowote wa vipengele hivi:

Rasilimali

Rasilimali hutoa muktadha na data kwa mtumiaji au mfano wa AI kutumia:

  • Hifadhi za nyaraka
  • Misingi ya maarifa
  • Vyanzo vya data vilivyopangwa
  • Mifumo ya faili

Maelekezo

Maelekezo ni ujumbe na michakato ya kazi iliyotengenezwa kwa mtumiaji:

  • Violezo vya mazungumzo vilivyowekwa awali
  • Mifumo ya maingiliano iliyoongozwa
  • Miundo maalum ya mazungumzo

Zana

Zana ni kazi ambazo mfano wa AI hutekeleza:

  • Zana za usindikaji data
  • Muunganisho wa API za nje
  • Uwezo wa kihesabu
  • Kazi za utafutaji

Mifano ya Utekelezaji: C#

Hifadhi rasmi ya SDK ya C# ina mifano kadhaa ya utekelezaji inayoonyesha nyanja tofauti za MCP:

  • Mteja wa MCP wa Msingi: Mfano rahisi unaoonyesha jinsi ya kuunda mteja wa MCP na kutumia zana
  • Seva ya MCP ya Msingi: Utekelezaji mdogo wa seva na usajili wa zana za msingi
  • Seva ya MCP ya Juu: Seva yenye vipengele kamili ikiwa na usajili wa zana, uthibitishaji, na usimamizi wa makosa
  • Muunganisho wa ASP.NET: Mifano inayoonyesha muunganisho na ASP.NET Core
  • Mifumo ya Utekelezaji wa Zana: Mifumo mbalimbali ya kutekeleza zana zenye ngazi tofauti za ugumu

SDK ya MCP ya C# iko katika awamu ya majaribio na API zinaweza kubadilika. Tutaendelea kusasisha blogi hii kadri SDK inavyoendelea.

Vipengele Muhimu

Kwa mifano kamili ya utekelezaji wa C#, tembelea hifadhi rasmi ya mifano ya SDK ya C#

Mfano wa Utekelezaji: Java

SDK ya Java inatoa chaguzi thabiti za utekelezaji wa MCP zenye vipengele vya kiwango cha biashara.

Vipengele Muhimu

  • Muunganisho wa Spring Framework
  • Usalama wa aina kali
  • Msaada wa programu ya reactive
  • Usimamizi kamili wa makosa

Kwa mfano kamili wa utekelezaji wa Java, angalia mfano wa Java katika saraka ya mifano.

Mfano wa Utekelezaji: JavaScript

SDK ya JavaScript hutoa njia nyepesi na yenye kubadilika kwa utekelezaji wa MCP.

Vipengele Muhimu

  • Msaada wa Node.js na kivinjari
  • API inayotumia ahadi (Promise-based)
  • Muunganisho rahisi na Express na mifumo mingine
  • Msaada wa WebSocket kwa mtiririko wa data

Kwa mfano kamili wa utekelezaji wa JavaScript, angalia mfano wa JavaScript katika saraka ya mifano.

Mfano wa Utekelezaji: Python

SDK ya Python hutoa njia ya Pythonic kwa utekelezaji wa MCP ikiwa na muunganisho bora wa mifumo ya ML.

Vipengele Muhimu

  • Msaada wa async/await kwa kutumia asyncio
  • Muunganisho wa FastAPI
  • Usajili rahisi wa zana
  • Muunganisho wa asili na maktaba maarufu za ML

Kwa mfano kamili wa utekelezaji wa Python, angalia mfano wa Python katika saraka ya mifano.

Usimamizi wa API

Azure API Management ni jibu zuri la jinsi tunavyoweza kulinda Seva za MCP. Wazo ni kuweka mfano wa Azure API Management mbele ya Seva yako ya MCP na kuiruhusu kushughulikia vipengele unavyoweza kuhitaji kama:

  • Kuzuia kiwango cha maombi
  • Usimamizi wa tokeni
  • Ufuatiliaji
  • Usawazishaji mzigo
  • Usalama

Mfano wa Azure

Hapa kuna Mfano wa Azure unaofanya hasa hivyo, yaani kuunda Seva ya MCP na kuilinda kwa Azure API Management.

Tazama jinsi mtiririko wa idhini unavyofanyika katika picha ifuatayo:

APIM-MCP

Katika picha hapo juu, yafanyika yafuatayo:

  • Uthibitishaji/Idhini hufanyika kwa kutumia Microsoft Entra.
  • Azure API Management hufanya kazi kama lango na hutumia sera kuongoza na kusimamia trafiki.
  • Azure Monitor hurekodi maombi yote kwa uchambuzi zaidi.

Mtiririko wa Idhini

Tuchunguze mtiririko wa idhini kwa undani zaidi:

Sequence Diagram

Maelezo ya Idhini ya MCP

Jifunze zaidi kuhusu Maelezo ya Idhini ya MCP

Kupeleka Seva ya MCP ya Mbali kwenye Azure

Tuchunguze kama tunaweza kupeleka mfano tulioelezea awali:

  1. Nakili hifadhi

    git clone https://github.com/Azure-Samples/remote-mcp-apim-functions-python.git
cd remote-mcp-apim-functions-python

  2. Sajili mtoa huduma wa rasilimali Microsoft.App.

    • Ikiwa unatumia Azure CLI, endesha az provider register --namespace Microsoft.App --wait.
    • Ikiwa unatumia Azure PowerShell, endesha Register-AzResourceProvider -ProviderNamespace Microsoft.App. Kisha endesha (Get-AzResourceProvider -ProviderNamespace Microsoft.App).RegistrationState baada ya muda kuona kama usajili umekamilika.

  3. Endesha amri hii ya azd kuandaa huduma ya usimamizi wa API, app ya kazi (ikiwa na msimbo) na rasilimali zote muhimu za Azure

    azd up

    Amri hizi zinapaswa kupeleka rasilimali zote za wingu kwenye Azure

Kuangalia seva yako kwa MCP Inspector

  1. Katika dirisha jipya la terminal, sakinisha na endesha MCP Inspector

    npx @modelcontextprotocol/inspector

    Unapaswa kuona kiolesura kinachofanana na:

    Connect to Node inspector

  2. Bonyeza CTRL ili kupakia app ya wavuti ya MCP Inspector kutoka URL inayotolewa na app (mfano http://127.0.0.1:6274/#resources)

  3. Weka aina ya usafirishaji kuwa SSE

  4. Weka URL ya mwisho wa API Management SSE unaoendesha unaoonyeshwa baada ya azd up na Unganisha:

    https://<apim-servicename-from-azd-output>.azure-api.net/mcp/sse

  5. Orodhesha Zana. Bonyeza zana na Endesha Zana.

Kama hatua zote zimefanikiwa, sasa unapaswa kuwa umeunganishwa na seva ya MCP na umeweza kuita zana.

Seva za MCP kwa Azure

Remote-mcp-functions: Seti hii ya hifadhi ni templeti ya kuanza haraka kwa kujenga na kupeleka seva za MCP za mbali (Model Context Protocol) kwa kutumia Azure Functions na Python, C# .NET au Node/TypeScript.

Mifano hutoa suluhisho kamili linalowezesha watengenezaji:

  • Kujenga na kuendesha kwa ndani: Kuendeleza na kutatua matatizo ya seva ya MCP kwenye mashine ya ndani
  • Kupeleka kwenye Azure: Kupeleka kwa urahisi kwenye wingu kwa amri rahisi ya azd up
  • Kuunganishwa kutoka kwa wateja: Kuungana na seva ya MCP kutoka kwa wateja mbalimbali ikiwa ni pamoja na hali ya wakala wa Copilot wa VS Code na zana ya MCP Inspector

Vipengele Muhimu:

  • Usalama kwa muundo: Seva ya MCP inalindwa kwa kutumia funguo na HTTPS
  • Chaguzi za uthibitishaji: Inasaidia OAuth kwa kutumia uthibitishaji uliopo na/au API Management
  • Kutengwa kwa mtandao: Inaruhusu kutengwa kwa mtandao kwa kutumia Azure Virtual Networks (VNET)
  • Muundo usio na seva: Inatumia Azure Functions kwa utekelezaji unaoweza kupanuka na unaoendeshwa na matukio
  • Maendeleo ya ndani: Msaada kamili wa maendeleo na utatuzi wa matatizo kwa ndani
  • Upelekaji rahisi: Mchakato rahisi wa kupeleka kwenye Azure

Hifadhi ina faili zote muhimu za usanidi, msimbo wa chanzo, na maelezo ya miundombinu ili kuanza haraka na utekelezaji wa seva ya MCP inayotumika uzalishaji.

Muhimu wa Kumbuka

  • SDK za MCP hutoa zana maalum za lugha kwa utekelezaji wa suluhisho thabiti za MCP
  • Mchakato wa kutatua matatizo na kujaribu ni muhimu kwa programu za MCP zinazotegemewa
  • Violezo vya maelekezo vinavyoweza kutumika tena huwezesha maingiliano thabiti ya AI
  • Michakato iliyobuniwa vyema inaweza kuandaa kazi ngumu kwa kutumia zana nyingi
  • Kutekeleza suluhisho za MCP kunahitaji kuzingatia usalama, utendaji, na usimamizi wa makosa

Zoef

Buni mchakato wa vitendo wa MCP unaoshughulikia tatizo halisi katika eneo lako:

  1. Tambua zana 3-4 ambazo zitakuwa na msaada katika kutatua tatizo hili
  2. Tengeneza mchoro wa mchakato unaoonyesha jinsi zana hizi zinavyoshirikiana
  3. Tekeleza toleo la msingi la moja ya zana hizo kwa kutumia lugha unayopendelea
  4. Tengeneza kiolezo cha maelekezo kitakachosaidia mfano kutumia zana yako kwa ufanisi

Rasilimali Zaidi

Ifuatayo: Mada za Juu

Kiarifu cha Kutotegemea:
Hati hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI Co-op Translator. Ingawa tunajitahidi kwa 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 inapendekezwa. Hatubebei dhamana kwa kutoelewana au tafsiri potofu zinazotokana na matumizi ya tafsiri hii.