Käytännön toteutus on se vaihe, jossa Model Context Protocolin (MCP) voima konkretisoituu. Vaikka MCP:n teorian ja arkkitehtuurin ymmärtäminen on tärkeää, todellinen arvo syntyy, kun sovellat näitä käsitteitä rakentaaksesi, testataksesi ja ottaaksesi käyttöön ratkaisuja, jotka ratkaisevat oikean maailman ongelmia. Tämä luku yhdistää käsitteellisen tiedon ja käytännön kehityksen, ohjaten sinua MCP-pohjaisten sovellusten elävöittämisessä.
Olitpa kehittämässä älykkäitä avustajia, integroimassa tekoälyä liiketoimintaprosesseihin tai rakentamassa räätälöityjä työkaluja datan käsittelyyn, MCP tarjoaa joustavan perustan. Sen kieliriippumaton rakenne ja viralliset SDK:t suosituimmille ohjelmointikielille tekevät siitä helposti lähestyttävän laajalle kehittäjäjoukolle. Hyödyntämällä näitä SDK:ita voit nopeasti prototyypittää, iteröidä ja skaalata ratkaisuja eri alustoilla ja ympäristöissä.
Seuraavissa osioissa löydät käytännön esimerkkejä, koodinäytteitä ja käyttöönotto-strategioita, jotka näyttävät, miten MCP toteutetaan C#:ssa, Javassa, TypeScriptissä, JavaScriptissä ja Pythonissa. Opit myös, miten MCP-palvelimia virheenkorjataan ja testataan, hallitaan API-rajapintoja sekä otetaan ratkaisuja käyttöön pilvessä Azuren avulla. Nämä käytännön resurssit on suunniteltu nopeuttamaan oppimistasi ja auttamaan sinua rakentamaan luotettavia, tuotantovalmiita MCP-sovelluksia itsevarmasti.
Tämä oppitunti keskittyy MCP:n käytännön toteutukseen useilla ohjelmointikielillä. Tutustumme siihen, miten MCP SDK:ita käytetään C#:ssa, Javassa, TypeScriptissä, JavaScriptissä ja Pythonissa vahvojen sovellusten rakentamiseen, MCP-palvelinten virheenkorjaukseen ja testaamiseen sekä uudelleenkäytettävien resurssien, kehotteiden ja työkalujen luomiseen.
Tämän oppitunnin jälkeen osaat:
- Toteuttaa MCP-ratkaisuja virallisilla SDK:illa eri ohjelmointikielillä
- Virheenkorjata ja testata MCP-palvelimia systemaattisesti
- Luoda ja käyttää palvelintoimintoja (Resources, Prompts ja Tools)
- Suunnitella tehokkaita MCP-työnkulkuja monimutkaisiin tehtäviin
- Optimoida MCP-toteutuksia suorituskyvyn ja luotettavuuden näkökulmasta
Model Context Protocol tarjoaa viralliset SDK:t useille kielille:
Tässä osiossa esitellään käytännön esimerkkejä MCP:n toteuttamisesta useilla ohjelmointikielillä. Näytekoodit löytyvät samples-hakemistosta, järjestettynä kielittäin.
Repositoriossa on näytetoteutuksia seuraavilla kielillä:
Jokainen esimerkki havainnollistaa keskeisiä MCP-konsepteja ja toteutusmalleja kyseiselle kielelle ja ekosysteemille.
MCP-palvelimet voivat toteuttaa minkä tahansa yhdistelmän seuraavista ominaisuuksista:
Resources tarjoavat kontekstin ja datan käyttäjälle tai tekoälymallille:
- Asiakirjahakemistot
- Tietopohjat
- Rakenteelliset tietolähteet
- Tiedostojärjestelmät
Prompts ovat valmiiksi mallinnettuja viestejä ja työnkulkuja käyttäjille:
- Ennalta määritellyt keskustelumallit
- Ohjatut vuorovaikutuskuviot
- Erikoistuneet dialogirakenteet
Tools ovat toimintoja, joita tekoälymalli voi suorittaa:
- Datan käsittelytyökalut
- Ulkoiset API-integraatiot
- Laskennalliset toiminnot
- Hakutoiminnot
Virallinen C# SDK -repositorio sisältää useita esimerkkitoteutuksia, jotka havainnollistavat MCP:n eri puolia:
- Perus MCP Client: Yksinkertainen esimerkki MCP-clientin luomisesta ja työkalujen kutsumisesta
- Perus MCP Server: Minimipalvelin, jossa on perustyökalujen rekisteröinti
- Kehittynyt MCP Server: Täysimittainen palvelin, jossa on työkalujen rekisteröinti, autentikointi ja virheenkäsittely
- ASP.NET-integraatio: Esimerkkejä ASP.NET Core -integraatiosta
- Työkalujen toteutusmallit: Eri monimutkaisuustasojen työkalujen toteutusmalleja
MCP C# SDK on ennakkoversiossa, ja API:t voivat muuttua. Päivitämme tätä blogia jatkuvasti SDK:n kehittyessä.
Täydelliset C# toteutusnäytteet löytyvät virallisen C# SDK:n näytereposta
Java SDK tarjoaa vahvat MCP-toteutusvaihtoehdot yritystason ominaisuuksilla.
- Spring Framework -integraatio
- Vahva tyyppiturvallisuus
- Reaktiivisen ohjelmoinnin tuki
- Laaja virheenkäsittely
Täydellinen Java-toteutusnäyte löytyy Java-esimerkistä näytekansiosta.
JavaScript SDK tarjoaa kevyen ja joustavan tavan toteuttaa MCP.
- Tuki Node.js:lle ja selaimille
- Promise-pohjainen API
- Helppo integraatio Expressin ja muiden kehysten kanssa
- WebSocket-tuki suoratoistoon
Täydellinen JavaScript-toteutusnäyte löytyy JavaScript-esimerkistä näytekansiosta.
Python SDK tarjoaa pythonilaisen lähestymistavan MCP-toteutukseen erinomaisilla ML-kehysintegraatioilla.
- Async/await-tuki asyncio-kirjastolla
- Flask- ja FastAPI-integraatiot
- Yksinkertainen työkalujen rekisteröinti
- Natiivisti tuettu integraatio suosittuihin ML-kirjastoihin
Täydellinen Python-toteutusnäyte löytyy Python-esimerkistä näytekansiosta.
Azure API Management on erinomainen ratkaisu MCP-palvelinten suojaamiseen. Ajatuksena on laittaa Azure API Management -instanssi MCP-palvelimen eteen ja antaa sen hoitaa toiminnot, joita todennäköisesti tarvitset, kuten:
- nopeusrajoitukset
- tokenien hallinta
- valvonta
- kuormantasapaino
- tietoturva
Tässä on Azure-esimerkki, joka tekee juuri tämän, eli luo MCP-palvelimen ja suojaa sen Azure API Managementilla.
Katso, miten valtuutusprosessi etenee alla olevassa kuvassa:
Edellisessä kuvassa tapahtuu seuraavaa:
- Autentikointi/valtuutus tapahtuu Microsoft Entran avulla.
- Azure API Management toimii porttina ja käyttää sääntöjä liikenteen ohjaukseen ja hallintaan.
- Azure Monitor kirjaa kaikki pyynnöt myöhempää analyysiä varten.
Tutustutaan valtuutusprosessiin tarkemmin:
Lue lisää MCP Authorization -määrittelystä
Katsotaan, voimmeko ottaa käyttöön aiemmin mainitun esimerkin:
-
Klonkaa repo
git clone https://github.com/Azure-Samples/remote-mcp-apim-functions-python.git cd remote-mcp-apim-functions-python -
Rekisteröi
Microsoft.Appkomennolla
`` resource provider.- If you are using Azure CLI, run
az provider register --namespace Microsoft.App --wait. - If you are using Azure PowerShell, run
Register-AzResourceProvider -ProviderNamespace Microsoft.App. Then run(Get-AzResourceProvider -ProviderNamespace Microsoft.App).RegistrationState
odota hetki ja tarkista, onko rekisteröinti valmis.
- If you are using Azure CLI, run
-
Suorita tämä azd komento, jolla provisioidaan API Management -palvelu, funktiosovellus (koodin kanssa) ja kaikki muut tarvittavat Azure-resurssit
azd up
Tämä komento ottaa käyttöön kaikki pilvipalvelut Azureen
-
Avaa uusi komentorivi-ikkuna, asenna ja käynnistä MCP Inspector
npx @modelcontextprotocol/inspector
Näet käyttöliittymän, joka näyttää tältä:
-
CTRL-klikkaa ladataksesi MCP Inspector -web-sovelluksen sovelluksen näyttämästä URL-osoitteesta (esim. http://127.0.0.1:6274/#resources)
-
Aseta siirtotyyppi
SSE -
Set the URL to your running API Management SSE endpoint displayed after
azd upja Yhdistä:https://<apim-servicename-from-azd-output>.azure-api.net/mcp/sse
-
Listaa työkalut. Klikkaa työkalua ja valitse Run Tool.
Jos kaikki vaiheet onnistuivat, olet nyt yhteydessä MCP-palvelimeen ja pystyt kutsumaan työkalua.
Remote-mcp-functions: Tämä joukko repositorioita tarjoaa pika-alustat MCP-palvelimien rakentamiseen ja käyttöönottoon Azure Functions -ympäristössä Pythonilla, C# .NET:llä tai Node/TypeScriptillä.
Näytteet tarjoavat täydellisen ratkaisun, joka mahdollistaa kehittäjille:
- Paikallisen rakentamisen ja ajon: Kehitä ja virheenkorjaa MCP-palvelin paikallisella koneella
- Käyttöönoton Azureen: Helppo pilveen siirtyminen yksinkertaisella azd up -komennolla
- Yhteyden muodostamisen asiakkailta: Yhdistä MCP-palvelimeen eri asiakkailta, kuten VS Code Copilot -agenttimoodilla ja MCP Inspector -työkalulla
- Turvallisuus suunnittelusta lähtien: MCP-palvelin on suojattu avaimilla ja HTTPS:llä
- Autentikointivaihtoehdot: Tukee OAuth:ta sisäänrakennetulla autentikoinnilla ja/tai API Managementilla
- Verkkoinfrastruktuurin eristäminen: Mahdollistaa verkkoinfrastruktuurin eristämisen Azure Virtual Networkien (VNET) avulla
- Serverless-arkkitehtuuri: Hyödyntää Azure Functionsia skaalautuvaan, tapahtumapohjaiseen suoritukseen
- Paikallinen kehitys: Kattava tuki paikalliseen kehitykseen ja virheenkorjaukseen
- Yksinkertainen käyttöönotto: Sujuva käyttöönotto Azureen
Repositoriossa on kaikki tarvittavat konfiguraatiotiedostot, lähdekoodi ja infrastruktuurin määrittelyt, jotta pääset nopeasti alkuun tuotantovalmiin MCP-palvelimen toteutuksessa.
-
Azure Remote MCP Functions Python – MCP:n näytetoteutus Azure Functionsilla Pythonilla
-
Azure Remote MCP Functions .NET – MCP:n näytetoteutus Azure Functionsilla C# .NET:llä
-
Azure Remote MCP Functions Node/Typescript – MCP:n näytetoteutus Azure Functionsilla Node/TypeScriptillä
- MCP SDK:t tarjoavat kielikohtaiset työkalut vahvojen MCP-ratkaisujen toteutukseen
- Virheenkorjaus ja testaus ovat kriittisiä luotettaville MCP-sovelluksille
- Uudelleenkäytettävät kehotepohjat mahdollistavat johdonmukaiset tekoälyvuorovaikutukset
- Hyvin suunnitellut työnkulut voivat orkestroida monimutkaisia tehtäviä useilla työkaluilla
- MCP-ratkaisujen toteutuksessa on huomioitava tietoturva, suorituskyky ja virheenkäsittely
Suunnittele käytännön MCP-työnkulku, joka ratkaisee todellisen ongelman omalla alallasi:
- Tunnista 3–4 työkalua, jotka olisivat hyödyllisiä ongelman ratkaisemisessa
- Laadi työnkulun kaavio, joka näyttää, miten nämä työkalut toimivat yhdessä
- Toteuta perusversio yhdestä työkaluista valitsemallasi kielellä
- Luo kehotepohja, joka auttaa mallia käyttämään työkalua tehokkaasti
Seuraava: Edistyneet aiheet
Vastuuvapauslauseke:
Tämä asiakirja on käännetty käyttämällä tekoälypohjaista käännöspalvelua Co-op Translator. Vaikka pyrimme tarkkuuteen, huomioithan, että automaattiset käännökset saattavat sisältää virheitä tai epätarkkuuksia. Alkuperäistä asiakirjaa sen alkuperäiskielellä tulee pitää virallisena lähteenä. Tärkeiden tietojen osalta suositellaan ammattimaista ihmiskäännöstä. Emme ole vastuussa tämän käännöksen käytöstä aiheutuvista väärinymmärryksistä tai tulkinnoista.