Praktische implementatie is waar de kracht van het Model Context Protocol (MCP) tastbaar wordt. Hoewel het belangrijk is om de theorie en architectuur achter MCP te begrijpen, komt de echte waarde naar voren wanneer je deze concepten toepast om oplossingen te bouwen, testen en implementeren die echte problemen aanpakken. Dit hoofdstuk overbrugt de kloof tussen conceptuele kennis en hands-on ontwikkeling, en begeleidt je bij het tot leven brengen van MCP-gebaseerde applicaties.
Of je nu intelligente assistenten ontwikkelt, AI integreert in bedrijfsprocessen, of aangepaste tools bouwt voor dataverwerking, MCP biedt een flexibele basis. Dankzij het taalonafhankelijke ontwerp en officiële SDK's voor populaire programmeertalen is het toegankelijk voor een breed scala aan ontwikkelaars. Door gebruik te maken van deze SDK's kun je snel prototypen, itereren en je oplossingen opschalen over verschillende platforms en omgevingen.
In de volgende secties vind je praktische voorbeelden, voorbeeldcode en implementatiestrategieën die laten zien hoe je MCP implementeert in C#, Java, TypeScript, JavaScript en Python. Je leert ook hoe je MCP-servers debugt en test, API's beheert en oplossingen naar de cloud uitrolt met Azure. Deze hands-on bronnen zijn ontworpen om je leerproces te versnellen en je te helpen met vertrouwen robuuste, productieklare MCP-applicaties te bouwen.
Deze les richt zich op praktische aspecten van MCP-implementatie in meerdere programmeertalen. We verkennen hoe je MCP SDK's gebruikt in C#, Java, TypeScript, JavaScript en Python om robuuste applicaties te bouwen, MCP-servers te debuggen en testen, en herbruikbare resources, prompts en tools te creëren.
Aan het einde van deze les kun je:
- MCP-oplossingen implementeren met officiële SDK's in verschillende programmeertalen
- MCP-servers systematisch debuggen en testen
- Serverfuncties creëren en gebruiken (Resources, Prompts en Tools)
- Effectieve MCP-workflows ontwerpen voor complexe taken
- MCP-implementaties optimaliseren voor prestaties en betrouwbaarheid
Het Model Context Protocol biedt officiële SDK's voor meerdere talen:
Deze sectie biedt praktische voorbeelden van MCP-implementaties in verschillende programmeertalen. Je vindt voorbeeldcode in de samples map, georganiseerd per taal.
De repository bevat voorbeeldimplementaties in de volgende talen:
Elk voorbeeld laat belangrijke MCP-concepten en implementatiepatronen zien voor die specifieke taal en omgeving.
MCP-servers kunnen een combinatie van deze functies implementeren:
Resources bieden context en data die de gebruiker of het AI-model kan gebruiken:
- Documentenrepositories
- Kennisbanken
- Gestructureerde databronnen
- Bestandsystemen
Prompts zijn sjablonen voor berichten en workflows voor gebruikers:
- Vooraf gedefinieerde conversatiesjablonen
- Geleide interactiepatronen
- Gespecialiseerde dialoogstructuren
Tools zijn functies die het AI-model kan uitvoeren:
- Hulpmiddelen voor dataverwerking
- Integraties met externe API's
- Rekencapaciteiten
- Zoekfunctionaliteit
De officiële C# SDK-repository bevat meerdere voorbeeldimplementaties die verschillende aspecten van MCP demonstreren:
- Basis MCP Client: Eenvoudig voorbeeld van het maken van een MCP-client en het aanroepen van tools
- Basis MCP Server: Minimale serverimplementatie met basis tool-registratie
- Geavanceerde MCP Server: Volledig uitgeruste server met tool-registratie, authenticatie en foutafhandeling
- ASP.NET Integratie: Voorbeelden van integratie met ASP.NET Core
- Patronen voor toolimplementatie: Verschillende patronen voor het implementeren van tools met diverse complexiteitsniveaus
De MCP C# SDK is in preview en API's kunnen veranderen. We zullen deze blog blijven bijwerken naarmate de SDK zich ontwikkelt.
Voor complete C# implementatievoorbeelden, bezoek de officiële C# SDK voorbeeldrepository
De Java SDK biedt robuuste MCP-implementatieopties met enterprise-grade functionaliteiten.
- Integratie met Spring Framework
- Sterke typeveiligheid
- Ondersteuning voor reactief programmeren
- Uitgebreide foutafhandeling
Voor een volledige Java implementatievoorbeeld, zie Java sample in de samples map.
De JavaScript SDK biedt een lichte en flexibele aanpak voor MCP-implementatie.
- Ondersteuning voor Node.js en browsers
- Promise-gebaseerde API
- Gemakkelijke integratie met Express en andere frameworks
- WebSocket-ondersteuning voor streaming
Voor een volledige JavaScript implementatievoorbeeld, zie JavaScript sample in de samples map.
De Python SDK biedt een Pythonic aanpak voor MCP-implementatie met uitstekende integraties voor ML-frameworks.
- Async/await ondersteuning met asyncio
- Integratie met Flask en FastAPI
- Eenvoudige tool-registratie
- Natuurlijke integratie met populaire ML-bibliotheken
Voor een volledige Python implementatievoorbeeld, zie Python sample in de samples map.
Azure API Management is een uitstekende oplossing om MCP-servers te beveiligen. Het idee is om een Azure API Management-instantie voor je MCP-server te plaatsen en deze functies te laten afhandelen die je waarschijnlijk wilt, zoals:
- rate limiting
- tokenbeheer
- monitoring
- load balancing
- beveiliging
Hier is een Azure-voorbeeld dat precies dit doet, namelijk een MCP-server maken en beveiligen met Azure API Management.
Bekijk hoe de autorisatiestroom verloopt in de onderstaande afbeelding:
In de bovenstaande afbeelding gebeurt het volgende:
- Authenticatie/Autorisatie vindt plaats via Microsoft Entra.
- Azure API Management fungeert als gateway en gebruikt policies om het verkeer te sturen en beheren.
- Azure Monitor logt alle verzoeken voor verdere analyse.
Laten we de autorisatiestroom wat gedetailleerder bekijken:
Lees meer over de MCP Authorization specificatie
Laten we kijken of we het eerder genoemde voorbeeld kunnen implementeren:
-
Clone de repo
git clone https://github.com/Azure-Samples/remote-mcp-apim-functions-python.git cd remote-mcp-apim-functions-python -
Registreer
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).RegistrationStateen controleer na enige tijd of de registratie voltooid is.
- If you are using Azure CLI, run
-
Voer dit azd commando uit om de API Management-service, function app (met code) en alle andere benodigde Azure-resources te provisioneren
azd up
Dit commando zou alle cloudresources op Azure moeten implementeren.
-
Open een nieuw terminalvenster, installeer en start MCP Inspector
npx @modelcontextprotocol/inspector
Je zou een interface moeten zien zoals:
-
CTRL-klik om de MCP Inspector webapp te laden vanaf de URL die de app toont (bijv. http://127.0.0.1:6274/#resources)
-
Stel het transporttype in op
SSE -
Set the URL to your running API Management SSE endpoint displayed after
azd upen Verbind:https://<apim-servicename-from-azd-output>.azure-api.net/mcp/sse
-
Tools weergeven. Klik op een tool en Voer tool uit.
Als alle stappen gelukt zijn, ben je nu verbonden met de MCP-server en heb je een tool kunnen aanroepen.
Remote-mcp-functions: Deze set repositories is een quickstart-template voor het bouwen en implementeren van aangepaste remote MCP (Model Context Protocol) servers met Azure Functions in Python, C# .NET of Node/TypeScript.
De voorbeelden bieden een complete oplossing waarmee ontwikkelaars kunnen:
- Lokaal bouwen en draaien: Ontwikkel en debug een MCP-server op een lokale machine
- Implementeren naar Azure: Gemakkelijk implementeren naar de cloud met een eenvoudig azd up-commando
- Verbinden vanaf clients: Verbind met de MCP-server vanaf verschillende clients, waaronder VS Code's Copilot agent-modus en de MCP Inspector tool
- Security by design: De MCP-server is beveiligd met sleutels en HTTPS
- Authenticatie-opties: Ondersteunt OAuth met ingebouwde authenticatie en/of API Management
- Netwerkisolatie: Ondersteunt netwerkisolatie met Azure Virtual Networks (VNET)
- Serverless architectuur: Maakt gebruik van Azure Functions voor schaalbare, event-driven uitvoering
- Lokale ontwikkeling: Uitgebreide ondersteuning voor lokale ontwikkeling en debugging
- Eenvoudige implementatie: Gestroomlijnd implementatieproces naar Azure
De repository bevat alle benodigde configuratiebestanden, broncode en infrastructuurdefinities om snel aan de slag te gaan met een productieklare MCP-serverimplementatie.
-
Azure Remote MCP Functions Python - Voorbeeldimplementatie van MCP met Azure Functions in Python
-
Azure Remote MCP Functions .NET - Voorbeeldimplementatie van MCP met Azure Functions in C# .NET
-
Azure Remote MCP Functions Node/Typescript - Voorbeeldimplementatie van MCP met Azure Functions in Node/TypeScript.
- MCP SDK's bieden taalspecifieke tools voor het implementeren van robuuste MCP-oplossingen
- Het debuggen en testen is cruciaal voor betrouwbare MCP-applicaties
- Herbruikbare prompt-sjablonen zorgen voor consistente AI-interacties
- Goed ontworpen workflows kunnen complexe taken orkestreren met meerdere tools
- Het implementeren van MCP-oplossingen vereist aandacht voor beveiliging, prestaties en foutafhandeling
Ontwerp een praktische MCP-workflow die een reëel probleem in jouw vakgebied aanpakt:
- Identificeer 3-4 tools die nuttig zouden zijn om dit probleem op te lossen
- Maak een workflowdiagram waarin je laat zien hoe deze tools samenwerken
- Implementeer een basisversie van een van de tools in jouw favoriete taal
- Maak een prompt-sjabloon dat het model helpt om je tool effectief te gebruiken
Volgende: Geavanceerde onderwerpen
Disclaimer:
Dit document is vertaald met behulp van de AI-vertalingsdienst Co-op Translator. Hoewel we streven naar nauwkeurigheid, dient u er rekening mee te houden dat geautomatiseerde vertalingen fouten of onnauwkeurigheden kunnen bevatten. Het oorspronkelijke document in de oorspronkelijke taal dient als de gezaghebbende bron te worden beschouwd. Voor cruciale informatie wordt professionele menselijke vertaling aanbevolen. Wij zijn niet aansprakelijk voor eventuele misverstanden of verkeerde interpretaties die voortvloeien uit het gebruik van deze vertaling.