Tools boven MCP (Model Context Protocol)
Zodra je app meer dan één tool heeft, verzint elke modelleverancier zijn eigen JSON-vorm om ze aan te roepen, en schrijf je uiteindelijk een adapter per aanbieder. Het Model Context Protocol (MCP) is de open standaard die dit oplost. Het is een JSON-RPC 2.0-protocol om tools (functies die het model kan aanroepen), resources (data die het kan lezen) en prompts beschikbaar te maken voor elke modelclient. Schrijf één keer een MCP-server en elke client die MCP kent (een IDE-assistent, een desktopapp, een agent) kan hem gebruiken.
Elk bericht is JSON-RPC 2.0, een piepkleine, vaste envelop. Een verzoek heeft altijd vier sleutels:
{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
"params": {"name": "add", "arguments": {"a": 2, "b": 3}}}De id koppelt een antwoord aan zijn verzoek. De server antwoordt met een respons die dezelfde id herhaalt en ofwel een result ofwel een error-object draagt, nooit allebei:
{"jsonrpc": "2.0", "id": 1, "result": {"content": [{"type": "text", "text": "5"}], "isError": false}}
{"jsonrpc": "2.0", "id": 1, "error": {"code": -32601, "message": "Method not found"}}De negatieve codes zijn standaard-JSON-RPC: -32601 is "method not found", -32602 is "invalid params", enzovoort. Een resultaat van tools/call heeft altijd die vorm: een lijst content met blokken (tekst, afbeeldingen, enzovoort) plus isError. Een tool die draaide maar mislukte (een foute plaatsnaam, bijvoorbeeld) antwoordt met isError: true in een normaal resultaat, zodat het model de mislukking kan lezen; het JSON-RPC-object error is voor protocolproblemen zoals een onbekende methode.
Een sessie begint met een handdruk: de client stuurt een verzoek initialize (zijn protocolversie, zijn mogelijkheden en zijn naam), de server antwoordt met zijn eigen mogelijkheden, en de client bevestigt met een melding notifications/initialized (een bericht zonder id, want niemand antwoordt erop). Pas dan ontdekt de client de tools door tools/list met lege params aan te roepen; de server geeft de lijst met toolbeschrijvingen terug.
Een echte MCP-server draait via stdio of HTTP en koppelt dit aan de SDK; hier bouwen en parsen we de berichten met de module json uit de standaardbibliotheek, zodat het draadformaat concreet is. Je schrijft drie functies.
build_request(id, method, params)-> een JSON-string voor de envelop{"jsonrpc": "2.0", "id": id, "method": method, "params": params}. Gebruikjson.dumps.parse_response(text)-> zet de tekst om metjson.loads, eisjsonrpc == "2.0"(gooi anders eenValueError). Heeft hij eenresult, geef dan{"id": ..., "ok": True, "result": ...}terug. Heeft hij eenerror, geef dan{"id": ..., "ok": False, "error": {"code": ..., "message": ...}}terug. Heeft hij geen van beide, gooi dan eenValueError.list_tools_request(id)-> het verzoek om tools te ontdekken: eenbuild_requestmet methode"tools/list"en legeparams{}.
Omdat build_request een string teruggeeft, parsen de tests hem terug met json.loads en vergelijken ze het dict, dus de volgorde van de sleutels doet er niet toe. Zorg dat een resultaat en een fout allebei heen en terug kloppen, dat het ontdekkingsverzoek de juiste methode heeft, en dat een bericht zonder jsonrpc of zonder result en error een fout geeft.
Bouw en parse MCP-stijl JSON-RPC 2.0 berichten met de json module. build_request(id, method, params) geeft de JSON string voor {"jsonrpc": "2.0", "id", "method", "params"} terug. parse_response(text) laadt de tekst, vereist jsonrpc == "2.0" (anders gooi ValueError op) en geeft {"id", "ok": True, "result"} terug voor een resultaat of {"id", "ok": False, "error": {"code", "message"}} voor een fout, en gooit op als het geen van beide heeft. list_tools_request(id) geeft de tools/list discovery request terug (verzonden na de handshake) met lege params.
Een probleem ontdekt in deze les? Meld het · Vraag naar deze les
Deze oefening opent binnenkort
Maak de les ervoor af voordat deze wordt ontgrendeld. De hele cursus is gratis, geen account nodig, en je kunt deze les nu lezen.
Deze browser blokkeert cookies voor learn.floati.life, dus lessen die je hier hebt afgerond kunnen niet in de juiste volgorde worden geopend. Sta cookies toe voor deze site en laad de pagina opnieuw.