Praktisk implementering er, hvor kraften i Model Context Protocol (MCP) bliver håndgribelig. Selvom det er vigtigt at forstå teorien og arkitekturen bag MCP, opstår den reelle værdi, når du anvender disse koncepter til at bygge, teste og implementere løsninger, der løser virkelige problemer. Dette kapitel bygger bro mellem konceptuel viden og praktisk udvikling og guider dig gennem processen med at bringe MCP-baserede applikationer til live.
Uanset om du udvikler intelligente assistenter, integrerer AI i forretningsprocesser eller bygger specialværktøjer til databehandling, giver MCP et fleksibelt fundament. Dets sprogagnostiske design og officielle SDK’er til populære programmeringssprog gør det tilgængeligt for en bred vifte af udviklere. Ved at udnytte disse SDK’er kan du hurtigt prototype, iterere og skalere dine løsninger på tværs af forskellige platforme og miljøer.
I de følgende afsnit finder du praktiske eksempler, kodeeksempler og implementeringsstrategier, der viser, hvordan du implementerer MCP i C#, Java, TypeScript, JavaScript og Python. Du lærer også, hvordan du debugger og tester dine MCP-servere, administrerer API’er og implementerer løsninger i skyen ved hjælp af Azure. Disse praktiske ressourcer er designet til at fremskynde din læring og hjælpe dig med trygt at bygge robuste, produktionsklare MCP-applikationer.
Denne lektion fokuserer på de praktiske aspekter af MCP-implementering på tværs af flere programmeringssprog. Vi vil udforske, hvordan man bruger MCP SDK’er i C#, Java, TypeScript, JavaScript og Python til at bygge robuste applikationer, debugge og teste MCP-servere samt skabe genanvendelige ressourcer, prompts og værktøjer.
Når du er færdig med denne lektion, vil du kunne:
- Implementere MCP-løsninger ved hjælp af officielle SDK’er i forskellige programmeringssprog
- Debugge og teste MCP-servere systematisk
- Oprette og bruge serverfunktioner (Ressourcer, Prompts og Værktøjer)
- Designe effektive MCP-arbejdsgange til komplekse opgaver
- Optimere MCP-implementeringer for ydeevne og pålidelighed
Model Context Protocol tilbyder officielle SDK’er til flere sprog:
Dette afsnit giver praktiske eksempler på implementering af MCP på tværs af flere programmeringssprog. Du kan finde kodeeksempler i samples-mappen, organiseret efter sprog.
Repository’et indeholder eksempelimplementeringer i følgende sprog:
Hvert eksempel demonstrerer centrale MCP-koncepter og implementeringsmønstre for det specifikke sprog og økosystem.
MCP-servere kan implementere en hvilken som helst kombination af disse funktioner:
Ressourcer leverer kontekst og data til brugeren eller AI-modellen:
- Dokumentarkiver
- Vidensbaser
- Strukturerede datakilder
- Filsystemer
Prompts er skabelonbaserede beskeder og arbejdsgange til brugere:
- Foruddefinerede samtaleskabeloner
- Guidede interaktionsmønstre
- Specialiserede dialogstrukturer
Værktøjer er funktioner, som AI-modellen kan udføre:
- Data behandlingsværktøjer
- Integrationer med eksterne API’er
- Beregningsfunktioner
- Søgefunktionalitet
Det officielle C# SDK-repository indeholder flere eksempelimplementeringer, der demonstrerer forskellige aspekter af MCP:
- Basic MCP Client: Simpelt eksempel, der viser, hvordan man opretter en MCP-klient og kalder værktøjer
- Basic MCP Server: Minimal serverimplementering med grundlæggende værktøjsregistrering
- Advanced MCP Server: Fuldt udstyret server med værktøjsregistrering, autentificering og fejlhåndtering
- ASP.NET Integration: Eksempler, der viser integration med ASP.NET Core
- Tool Implementation Patterns: Forskellige mønstre til implementering af værktøjer med varierende kompleksitet
MCP C# SDK’et er i preview, og API’er kan ændre sig. Vi opdaterer løbende denne blog, efterhånden som SDK’et udvikler sig.
For komplette C# implementeringseksempler, besøg det officielle C# SDK samples repository
Java SDK tilbyder robuste MCP-implementeringsmuligheder med enterprise-grade funktioner.
- Spring Framework-integration
- Stærk typesikkerhed
- Understøttelse af reaktiv programmering
- Omfattende fejlhåndtering
For et komplet Java-implementeringseksempel, se Java sample i samples-mappen.
JavaScript SDK tilbyder en let og fleksibel tilgang til MCP-implementering.
- Understøttelse af Node.js og browsere
- Promise-baseret API
- Nem integration med Express og andre frameworks
- WebSocket-understøttelse til streaming
For et komplet JavaScript-implementeringseksempel, se JavaScript sample i samples-mappen.
Python SDK tilbyder en Pythonisk tilgang til MCP-implementering med fremragende integrationer til ML-rammer.
- Async/await-understøttelse med asyncio
- FastAPI-integration
- Enkel værktøjsregistrering
- Naturlig integration med populære ML-biblioteker
For et komplet Python-implementeringseksempel, se Python sample i samples-mappen.
Azure API Management er en fremragende løsning til at sikre MCP-servere. Ideen er at placere en Azure API Management-instans foran din MCP-server og lade den håndtere funktioner, du sandsynligvis vil have, såsom:
- ratebegrænsning
- tokenhåndtering
- overvågning
- load balancing
- sikkerhed
Her er et Azure-eksempel, der gør netop det, altså opretter en MCP-server og sikrer den med Azure API Management.
Se, hvordan autorisationsflowet foregår i nedenstående billede:
I det forrige billede sker følgende:
- Autentificering/autorisation foregår via Microsoft Entra.
- Azure API Management fungerer som en gateway og bruger politikker til at dirigere og styre trafikken.
- Azure Monitor logger alle forespørgsler til videre analyse.
Lad os se nærmere på autorisationsflowet:
Læs mere om MCP Authorization specification
Lad os se, om vi kan implementere det eksempel, vi nævnte tidligere:
-
Klon repoet
git clone https://github.com/Azure-Samples/remote-mcp-apim-functions-python.git cd remote-mcp-apim-functions-python -
Registrer
Microsoft.Appresource provider.- Hvis du bruger Azure CLI, kør
az provider register --namespace Microsoft.App --wait. - Hvis du bruger Azure PowerShell, kør
Register-AzResourceProvider -ProviderNamespace Microsoft.App. Kør derefter(Get-AzResourceProvider -ProviderNamespace Microsoft.App).RegistrationStateefter noget tid for at tjekke, om registreringen er fuldført.
- Hvis du bruger Azure CLI, kør
-
Kør denne azd kommando for at provisionere API Management-tjenesten, function app (med kode) og alle andre nødvendige Azure-ressourcer
azd up
Denne kommando bør implementere alle cloud-ressourcer på Azure
-
I et nyt terminalvindue, installer og kør MCP Inspector
npx @modelcontextprotocol/inspector
Du bør se en grænseflade som denne:
-
CTRL-klik for at åbne MCP Inspector webappen fra den URL, appen viser (f.eks. http://127.0.0.1:6274/#resources)
-
Sæt transporttypen til
SSE -
Sæt URL’en til din kørende API Management SSE-endpoint, som vises efter
azd up, og Connect:https://<apim-servicename-from-azd-output>.azure-api.net/mcp/sse
-
List Tools. Klik på et værktøj og Run Tool.
Hvis alle trin er gennemført korrekt, bør du nu være forbundet til MCP-serveren og have kunnet kalde et værktøj.
Remote-mcp-functions: Dette sæt af repositories er en quickstart-skabelon til at bygge og implementere tilpassede remote MCP (Model Context Protocol) servere ved hjælp af Azure Functions med Python, C# .NET eller Node/TypeScript.
Samples giver en komplet løsning, der gør det muligt for udviklere at:
- Bygge og køre lokalt: Udvikle og debugge en MCP-server på en lokal maskine
- Implementere til Azure: Nem implementering til skyen med en simpel azd up-kommando
- Forbinde fra klienter: Forbinde til MCP-serveren fra forskellige klienter, herunder VS Codes Copilot agent mode og MCP Inspector-værktøjet
- Sikkerhed by design: MCP-serveren sikres med nøgler og HTTPS
- Autentificeringsmuligheder: Understøtter OAuth med indbygget auth og/eller API Management
- Netværksisolation: Muliggør netværksisolation ved hjælp af Azure Virtual Networks (VNET)
- Serverløs arkitektur: Udnytter Azure Functions til skalerbar, eventdrevet eksekvering
- Lokal udvikling: Omfattende lokal udviklings- og debugstøtte
- Enkel implementering: Strømlinet implementeringsproces til Azure
Repository’et indeholder alle nødvendige konfigurationsfiler, kildekode og infrastrukturdefinitioner for hurtigt at komme i gang med en produktionsklar MCP-serverimplementering.
-
Azure Remote MCP Functions Python - Eksempelimplementering af MCP ved hjælp af Azure Functions med Python
-
Azure Remote MCP Functions .NET - Eksempelimplementering af MCP ved hjælp af Azure Functions med C# .NET
-
Azure Remote MCP Functions Node/Typescript - Eksempelimplementering af MCP ved hjælp af Azure Functions med Node/TypeScript.
- MCP SDK’er tilbyder sprog-specifikke værktøjer til at implementere robuste MCP-løsninger
- Debugging og testning er afgørende for pålidelige MCP-applikationer
- Genanvendelige promptskabeloner sikrer konsistente AI-interaktioner
- Veludformede arbejdsgange kan orkestrere komplekse opgaver ved hjælp af flere værktøjer
- Implementering af MCP-løsninger kræver fokus på sikkerhed, ydeevne og fejlhåndtering
Design en praktisk MCP-arbejdsgang, der løser et virkeligt problem inden for dit område:
- Identificer 3-4 værktøjer, der ville være nyttige til at løse dette problem
- Lav et arbejdsgangsdiagram, der viser, hvordan disse værktøjer interagerer
- Implementer en grundlæggende version af et af værktøjerne i dit foretrukne sprog
- Opret en promptskabelon, der hjælper modellen med effektivt at bruge dit værktøj
Næste: Avancerede emner
Ansvarsfraskrivelse:
Dette dokument er blevet oversat ved hjælp af AI-oversættelsestjenesten Co-op Translator. Selvom vi bestræber os på nøjagtighed, bedes du være opmærksom på, at automatiserede oversættelser kan indeholde fejl eller unøjagtigheder. Det oprindelige dokument på dets oprindelige sprog bør betragtes som den autoritative kilde. For kritisk information anbefales professionel menneskelig oversættelse. Vi påtager os intet ansvar for misforståelser eller fejltolkninger, der opstår som følge af brugen af denne oversættelse.