Praktisk implementering är där kraften i Model Context Protocol (MCP) blir påtaglig. Även om det är viktigt att förstå teorin och arkitekturen bakom MCP, uppstår det verkliga värdet när du tillämpar dessa koncept för att bygga, testa och distribuera lösningar som löser verkliga problem. Detta kapitel överbryggar klyftan mellan konceptuell kunskap och praktisk utveckling, och guidar dig genom processen att förverkliga MCP-baserade applikationer.
Oavsett om du utvecklar intelligenta assistenter, integrerar AI i affärsflöden eller bygger specialanpassade verktyg för databehandling, erbjuder MCP en flexibel grund. Dess språkoberoende design och officiella SDK:er för populära programmeringsspråk gör det tillgängligt för en bred utvecklarkrets. Genom att använda dessa SDK:er kan du snabbt skapa prototyper, iterera och skala dina lösningar över olika plattformar och miljöer.
I följande avsnitt hittar du praktiska exempel, kodexempel och distributionsstrategier som visar hur du implementerar MCP i C#, Java, TypeScript, JavaScript och Python. Du kommer också att lära dig hur du felsöker och testar dina MCP-servrar, hanterar API:er och distribuerar lösningar till molnet med Azure. Dessa praktiska resurser är utformade för att påskynda din inlärning och hjälpa dig att tryggt bygga robusta och produktionsklara MCP-applikationer.
Den här lektionen fokuserar på praktiska aspekter av MCP-implementering i flera programmeringsspråk. Vi kommer att utforska hur man använder MCP SDK:er i C#, Java, TypeScript, JavaScript och Python för att bygga robusta applikationer, felsöka och testa MCP-servrar samt skapa återanvändbara resurser, prompts och verktyg.
Efter denna lektion kommer du att kunna:
- Implementera MCP-lösningar med hjälp av officiella SDK:er i olika programmeringsspråk
- Felsöka och testa MCP-servrar systematiskt
- Skapa och använda serverfunktioner (Resurser, Prompts och Verktyg)
- Designa effektiva MCP-arbetsflöden för komplexa uppgifter
- Optimera MCP-implementeringar för prestanda och tillförlitlighet
Model Context Protocol erbjuder officiella SDK:er för flera språk:
Detta avsnitt ger praktiska exempel på hur MCP implementeras i flera programmeringsspråk. Du hittar kodexempel i samples-katalogen organiserad efter språk.
Förrådet inkluderar exempel på implementationer i följande språk:
Varje exempel visar viktiga MCP-koncept och implementationsmönster för det specifika språket och ekosystemet.
MCP-servrar kan implementera en kombination av följande funktioner:
Resurser tillhandahåller kontext och data som användaren eller AI-modellen kan använda:
- Dokumentarkiv
- Kunskapsbaser
- Strukturerade datakällor
- Filsystem
Prompts är mallade meddelanden och arbetsflöden för användare:
- Fördefinierade konversationsmallar
- Guidad interaktionsmönster
- Specialiserade dialogstrukturer
Verktyg är funktioner som AI-modellen kan utföra:
- Verktyg för databehandling
- Integrationer med externa API:er
- Beräkningsfunktioner
- Sökfunktionalitet
Det officiella C# SDK-förrådet innehåller flera exempel som visar olika aspekter av MCP:
- Basic MCP Client: Enkelt exempel som visar hur man skapar en MCP-klient och anropar verktyg
- Basic MCP Server: Minimal serverimplementation med grundläggande verktygsregistrering
- Advanced MCP Server: Fullfjädrad server med verktygsregistrering, autentisering och felhantering
- ASP.NET Integration: Exempel som visar integration med ASP.NET Core
- Verktygsimplementationsmönster: Olika mönster för att implementera verktyg med varierande komplexitet
MCP C# SDK är i förhandsversion och API:er kan ändras. Vi kommer att kontinuerligt uppdatera denna blogg i takt med att SDK:n utvecklas.
För kompletta C# implementationsexempel, besök det officiella C# SDK-exempelförrådet
Java SDK erbjuder robusta MCP-implementeringsalternativ med företagsklassade funktioner.
- Integration med Spring Framework
- Stark typkontroll
- Stöd för reaktiv programmering
- Omfattande felhantering
För ett komplett exempel på Java-implementation, se Java sample i exempelkatalogen.
JavaScript SDK erbjuder ett lättviktigt och flexibelt sätt att implementera MCP.
- Stöd för Node.js och webbläsare
- Promise-baserat API
- Enkel integration med Express och andra ramverk
- WebSocket-stöd för streaming
För ett komplett exempel på JavaScript-implementation, se JavaScript sample i exempelkatalogen.
Python SDK erbjuder ett pythoniskt sätt att implementera MCP med utmärkta integrationer för ML-ramverk.
- Async/await-stöd med asyncio
- Integration med Flask och FastAPI
- Enkel verktygsregistrering
- Inbyggd integration med populära ML-bibliotek
För ett komplett exempel på Python-implementation, se Python sample i exempelkatalogen.
Azure API Management är en utmärkt lösning för hur vi kan säkra MCP-servrar. Idén är att placera en Azure API Management-instans framför din MCP-server och låta den hantera funktioner som du troligtvis vill ha, såsom:
- begränsning av anropstakt
- tokenhantering
- övervakning
- lastbalansering
- säkerhet
Här är ett Azure-exempel som gör just detta, dvs skapar en MCP-server och säkrar den med Azure API Management.
Se hur auktoriseringsflödet går till i bilden nedan:
I bilden ovan sker följande:
- Autentisering/Auktorisering sker via Microsoft Entra.
- Azure API Management fungerar som en gateway och använder policyer för att styra och hantera trafiken.
- Azure Monitor loggar alla förfrågningar för vidare analys.
Låt oss titta närmare på auktoriseringsflödet:
Läs mer om MCP Authorization specification
Låt oss se om vi kan distribuera exemplet vi nämnde tidigare:
-
Klona förrådet
git clone https://github.com/Azure-Samples/remote-mcp-apim-functions-python.git cd remote-mcp-apim-functions-python -
Registrera
Microsoft.Appresource 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).RegistrationStateoch vänta en stund för att kontrollera om registreringen är klar.
- If you are using Azure CLI, run
-
Kör detta azd-kommando för att provisionera API Management-tjänsten, function app (med kod) och alla andra nödvändiga Azure-resurser
azd up
Detta kommando ska distribuera alla molnresurser på Azure
-
I ett nytt terminalfönster, installera och kör MCP Inspector
npx @modelcontextprotocol/inspector
Du bör se ett gränssnitt som liknar:
-
CTRL-klicka för att ladda MCP Inspector web app från URL:en som visas av appen (t.ex. http://127.0.0.1:6274/#resources)
-
Ställ in transporttyp till
SSE -
Set the URL to your running API Management SSE endpoint displayed after
azd upoch Connect:https://<apim-servicename-from-azd-output>.azure-api.net/mcp/sse
-
Lista verktyg. Klicka på ett verktyg och Run Tool.
Om alla steg fungerat ska du nu vara ansluten till MCP-servern och ha kunnat anropa ett verktyg.
Remote-mcp-functions: Denna uppsättning förråd är en snabbstartsmall för att bygga och distribuera anpassade fjärr-MCP (Model Context Protocol) servrar med Azure Functions i Python, C# .NET eller Node/TypeScript.
Exemplen erbjuder en komplett lösning som låter utvecklare:
- Bygga och köra lokalt: Utveckla och felsöka en MCP-server på en lokal maskin
- Distribuera till Azure: Enkel distribution till molnet med ett enda azd up-kommando
- Ansluta från klienter: Anslut till MCP-servern från olika klienter, inklusive VS Code:s Copilot agent-läge och MCP Inspector-verktyget
- Säkerhet från början: MCP-servern är säkrad med nycklar och HTTPS
- Autentiseringsalternativ: Stödjer OAuth med inbyggd autentisering och/eller API Management
- Nätverksisolering: Möjliggör nätverksisolering med Azure Virtual Networks (VNET)
- Serverlös arkitektur: Utnyttjar Azure Functions för skalbar, händelsestyrd exekvering
- Lokal utveckling: Omfattande stöd för lokal utveckling och felsökning
- Enkel distribution: Effektiv distributionsprocess till Azure
Förrådet innehåller alla nödvändiga konfigurationsfiler, källkod och infrastrukturbeskrivningar för att snabbt komma igång med en produktionsklar MCP-serverimplementation.
-
Azure Remote MCP Functions Python - Exempel på MCP-implementation med Azure Functions och Python
-
Azure Remote MCP Functions .NET - Exempel på MCP-implementation med Azure Functions och C# .NET
-
Azure Remote MCP Functions Node/Typescript - Exempel på MCP-implementation med Azure Functions och Node/TypeScript.
- MCP SDK:er erbjuder språksspecifika verktyg för att implementera robusta MCP-lösningar
- Felsöknings- och testprocessen är avgörande för pålitliga MCP-applikationer
- Återanvändbara promptmallar möjliggör konsekventa AI-interaktioner
- Väl utformade arbetsflöden kan orkestrera komplexa uppgifter med flera verktyg
- Att implementera MCP-lösningar kräver hänsyn till säkerhet, prestanda och felhantering
Designa ett praktiskt MCP-arbetsflöde som löser ett verkligt problem inom ditt område:
- Identifiera 3-4 verktyg som skulle vara användbara för att lösa detta problem
- Skapa ett arbetsflödesdiagram som visar hur dessa verktyg samverkar
- Implementera en grundläggande version av ett av verktygen med ditt föredragna språk
- Skapa en promptmall som hjälper modellen att effektivt använda ditt verktyg
Nästa: Avancerade ämnen
Ansvarsfriskrivning:
Detta dokument har översatts med hjälp av AI-översättningstjänsten Co-op Translator. Även om vi strävar efter noggrannhet, vänligen observera att automatiska översättningar kan innehålla fel eller brister. Det ursprungliga dokumentet på dess modersmål ska betraktas som den auktoritativa källan. För kritisk information rekommenderas professionell mänsklig översättning. Vi ansvarar inte för några missförstånd eller feltolkningar som uppstår till följd av användningen av denna översättning.