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 anpassade 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 utnyttja dessa SDK:er kan du snabbt prototypa, 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, produktionsklara MCP-applikationer.
Denna lektion 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.
I slutet av denna lektion kommer du att kunna:
- Implementera MCP-lösningar med officiella SDK:er i olika programmeringsspråk
- Felsöka och testa MCP-servrar systematiskt
- Skapa och använda serverfunktioner (Resources, Prompts och Tools)
- Designa effektiva MCP-arbetsflöden för komplexa uppgifter
- Optimera MCP-implementationer 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 man implementerar MCP i flera programmeringsspråk. Du hittar exempel i samples-katalogen organiserade efter språk.
Förrådet innehåller exempelimplementationer 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 vilken kombination som helst av dessa funktioner:
Resources tillhandahåller kontext och data för användaren eller AI-modellen att 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
Tools är funktioner som AI-modellen kan utföra:
- Verktyg för databehandling
- Integrationer med externa API:er
- Beräkningsfunktioner
- Sökmöjligheter
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
- Tool Implementation Patterns: Olika mönster för att implementera verktyg med varierande komplexitet
MCP C# SDK är i förhandsgranskning och API:erna kan komma att ändras. Vi kommer kontinuerligt att 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 Java-implementationsprov, se Java sample i exempel-katalogen.
JavaScript SDK erbjuder ett lättviktigt och flexibelt tillvägagångssätt för MCP-implementering.
- 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 JavaScript-implementationsprov, se JavaScript sample i exempel-katalogen.
Python SDK erbjuder ett Pythoniskt tillvägagångssätt för MCP-implementering med utmärkta integrationer för ML-ramverk.
- Async/await-stöd med asyncio
- FastAPI-integration
- Enkel verktygsregistrering
- Naturlig integration med populära ML-bibliotek
För ett komplett Python-implementationsprov, se Python sample i exempel-katalogen.
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 sannolikt vill ha, såsom:
- begränsning av anrop (rate limiting)
- 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 sker 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 policies 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 repot
git clone https://github.com/Azure-Samples/remote-mcp-apim-functions-python.git cd remote-mcp-apim-functions-python -
Registrera
Microsoft.Appresursleverantör.- Om du använder Azure CLI, kör
az provider register --namespace Microsoft.App --wait. - Om du använder Azure PowerShell, kör
Register-AzResourceProvider -ProviderNamespace Microsoft.App. Kör sedan(Get-AzResourceProvider -ProviderNamespace Microsoft.App).RegistrationStateefter en stund för att kontrollera om registreringen är klar.
- Om du använder Azure CLI, kör
-
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 bör 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 webbappen från den URL som appen visar (t.ex. http://127.0.0.1:6274/#resources)
-
Ställ in transporttypen till
SSE -
Ange URL:en till din körande API Management SSE-endpoint som visas efter
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 enkelt azd up-kommando
- Ansluta från klienter: Anslut till MCP-servern från olika klienter inklusive VS Codes Copilot agentläge och MCP Inspector-verktyget
- Säkerhet från början: MCP-servern är säkrad med nycklar och HTTPS
- Autentiseringsalternativ: Stöd för 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: Strömlinjeformad 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 - Exempelimplementation av MCP med Azure Functions i Python
-
Azure Remote MCP Functions .NET - Exempelimplementation av MCP med Azure Functions i C# .NET
-
Azure Remote MCP Functions Node/Typescript - Exempelimplementation av MCP med Azure Functions i 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
- Implementering av 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 bör 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.