Kurrikulum Leson 139 van 250 · Gestruktureerde Uitsettes & Funksie/Gereedskap Roeping
Gestruktureerde Uitsettes & Funksie/Gereedskap Roeping

Gereedskap oor MCP (Model Context Protocol)

Sodra jou app meer as een hulpmiddel het, skep elke modelverskaffer sy eie JSON-vorm om hulle te roep, en jy eindig op om 'n adapter per verskaffer te skryf. Die Model Context Protocol (MCP) is die oop standaard wat dit regstel. Dit is 'n JSON-RPC 2.0 draadprotokol om tools (funksies wat die model kan roep), resources (data wat dit kan lees), en prompts aan enige modelkliënt bloot te stel. Skryf 'n MCP-bediener een keer en enige MCP-bewuste kliënt ('n IDE-assistent, 'n skermtoepassing, 'n agent) kan dit gebruik.

Elke boodskap is JSON-RPC 2.0, wat 'n klein, vaste omhulsel is. 'n request dra altyd vier sleutels:

{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
 "params": {"name": "add", "arguments": {"a": 2, "b": 3}}}

Die id verbind 'n antwoord aan sy versoek. Die bediener antwoord met 'n response wat dieselfde id weerspieël en either 'n result or 'n error objek dra, nooit albei nie:

{"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"}}

Die negatiewe kodes is standaard JSON-RPC: -32601 is "method not found", -32602 is "invalid params", en so aan. 'n tools/call resultaat het altyd daardie vorm: 'n content lys van blokke (teks, beelde, ens.) plus isError. 'n Tool wat hardloop maar faal ( 'n slegte stadsnaam, byvoorbeeld) antwoord met isError: true in 'n normale resultaat, sodat die model die fout kan lees; die JSON-RPC error objek is vir protokolprobleme soos 'n onbekende metode.

A-sessie begin met 'n handshake: die kliënt stuur 'n initialize-aanvraag (sy protokolweergawe, sy vermoëns en sy naam), die bediener antwoord met sy eie vermoëns, en die kliënt bevestig met 'n notifications/initialized-kennisgewing ( 'n boodskap sonder 'n id, want niemand antwoord daarop nie). Dans die kliënt eers discover die gereedskap deur tools/list met leë params te roep; die bediener gee die lys van tool descriptors terug.

'n

A regte MCP-bediener loop oor stdio of HTTP en verbind dit met die SDK; hier bou en parse ons die boodskappe met die standaardbibliêk json-module sodat die dra-formaat konkreet is. Jy skryf drie funksies.

  • build_request(id, method, params) -> 'n JSON string vir die omhulsel {"jsonrpc": "2.0", "id": id, "method": method, "params": params}. Gebruik json.dumps.
  • parse_response(text) -> json.loads die teks, vereis jsonrpc == "2.0" (gooi ValueError andersin). As dit 'n result het, gee {"id": ..., "ok": True, "result": ...} terug. As dit 'n error het, gee {"id": ..., "ok": False, "error": {"code": ..., "message": ...}} terug. As dit geen van die twee het nie, gooi ValueError.
  • list_tools_request(id) -> die hulpmiddel-ontdekkingsversoek: 'n build_request met metode "tools/list" en leë params {}.

Omdat build_request 'n string teruggee, parse die toetse dit terug met json.loads en vergelyk die dict, so die sleutelorde maak nie saak nie. Maak seker dat 'n resultaat en 'n fout albei rondgaan, die discovery request die regte metode het, en 'n boodskap wat jsonrpc kort of geen result of error het, fout gee.

Jou beurt

Bou en parse MCP-styl JSON-RPC 2.0 boodskappe met die json module. build_request(id, method, params) gee die JSON string vir {"jsonrpc": "2.0", "id", "method", "params"} terug. parse_response(text) laai die teks, vereis jsonrpc == "2.0" (anders dan gooi ValueError), en gee {"id", "ok": True, "result"} terug vir 'n resultaat of {"id", "ok": False, "error": {"code", "message"}} vir 'n fout, en gooi as dit geen van die twee het nie. list_tools_request(id) gee die tools/list discovery request terug (gestuur na die handshake) met leë params.

Sien jy 'n probleem in hierdie les? Rapporteer dit · Vra oor hierdie les

Hierdie oefening open binnekort

Voltooi die lesie voor dit en hierdie een sal ontvanklik wees. Die hele kursus is gratis, geen rekening nodig nie, en jy kan hierdie les nou lees.