Bouw je eerste MCP-server in Python (Stateless Spec editie)

Samenvatting

MCP wordt stateless in de specificatie van 28 juli 2026, terwijl Python SDK v2 servers bouwt met gewone functies.

MCP en de stateless specificatie

De MCP-specificatie van 2026-07-28 maakt het protocol stateless. Clients hoeven niet langer eerst een protocolsessie op te zetten en servers gebruiken Mcp-Session-Id niet meer voor gewone verzoeken. Elk verzoek bevat alle informatie die nodig is om het af te handelen.

Dat past direct bij HTTP-infrastructuur. Een server kan zonder gebruikerssessies werken en blijft daardoor eenvoudig achter reguliere HTTP-componenten te plaatsen. Het artikel demonstreert dit met een kleine kennisbank voor ontwikkelaarsondersteuning.

Python SDK v2 en MCPServer

De actuele stabiele lijn van de officiële Python SDK is versie 2. Die SDK biedt MCPServer als hogere serverinterface. Met gewone Python-functies definieert de ontwikkelaar drie MCP-primitieven: de tool search_kb, de resource kb://articles en de prompt draft_support_reply.

De tutorial gebruikt Python 3.10 of nieuwer. Een project bestaat uit server.py en client.py. Installatie kan met uv add mcp[cli] of pip install mcp[cli]. De CLI-extra levert ook het ontwikkelcommando en de MCP Inspector-workflow.

De SDK bevat daarnaast de lagere Server-klasse. Die past bij situaties waarin exacte controle over schema’s, protocolmetadata of aangepaste methoden nodig is. Voor een standaardserver wijst het voorbeeld naar MCPServer.

MCP in een BI- en AI-omgeving

Voor BI-professionals laat dit voorbeeld zien hoe een model via één protocol toegang krijgt tot functies, bronnen en vooraf gedefinieerde prompts. De server bevat geen sessiestatus: een verzoek voor zoeken, documenttoegang of antwoordopbouw staat op zichzelf. Dat verschil raakt vooral de manier waarop je infrastructuur en foutafhandeling ontwerpt.

De tutorial test de server lokaal via Streamable HTTP en verbindt daarna een Python MCP-client. Daarmee ontstaat een klein, controleerbaar patroon voordat een MCP-server aan bestaande applicaties wordt gekoppeld.

Concrete takeaway voor MCP-projecten

Gebruik Python 3.10 of nieuwer, start met MCPServer en ontwerp elke aanvraag zonder afhankelijkheid van sessiestatus. Test vervolgens Streamable HTTP met de MCP Inspector en een aparte Python-client.