Strumenti via MCP (Model Context Protocol)
Una volta che la tua app ha più di uno strumento, ogni fornitore di modelli inventa la propria forma JSON per chiamarli, e finisci a scrivere un adattatore per ogni fornitore. Il Model Context Protocol (MCP) è lo standard aperto che risolve il problema. È un protocollo di comunicazione JSON-RPC 2.0 per esporre strumenti (funzioni che il modello può chiamare), risorse (dati che può leggere) e prompt a qualsiasi client di modelli. Scrivi un server MCP una volta e qualsiasi client che conosce MCP (un assistente in un IDE, un'app desktop, un agente) può usarlo.
Ogni messaggio è JSON-RPC 2.0, che è una busta minuscola e fissa. Una richiesta porta sempre quattro chiavi:
{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
"params": {"name": "add", "arguments": {"a": 2, "b": 3}}}L'id lega una risposta alla sua richiesta. Il server risponde con una risposta che riporta lo stesso id e porta o un result o un oggetto error, mai entrambi:
{"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"}}I codici negativi sono quelli standard di JSON-RPC: -32601 è "metodo non trovato", -32602 è "parametri non validi", e così via. Un risultato di tools/call ha sempre quella forma: una lista content di blocchi (testo, immagini e così via) più isError. Uno strumento che è stato eseguito ma ha fallito (un nome di città sbagliato, per esempio) risponde con isError: true in un risultato normale, così il modello può leggere il fallimento; l'oggetto error di JSON-RPC è per i problemi di protocollo come un metodo sconosciuto.
Una sessione comincia con una stretta di mano: il client manda una richiesta initialize (la sua versione del protocollo, le sue capacità e il suo nome), il server risponde con le proprie capacità, e il client conferma con una notifica notifications/initialized (un messaggio senza id, perché nessuno ci risponde). Solo allora il client scopre gli strumenti chiamando tools/list con parametri vuoti; il server restituisce la lista dei descrittori degli strumenti.
Un vero server MCP gira su stdio o HTTP e collega tutto questo all'SDK; qui costruiamo e leggiamo i messaggi con il modulo json della libreria standard così il formato di comunicazione diventa concreto. Stai scrivendo tre funzioni.
build_request(id, method, params)-> una stringa JSON per la busta{"jsonrpc": "2.0", "id": id, "method": method, "params": params}. Usajson.dumps.parse_response(text)-> faijson.loadsdel testo, pretendijsonrpc == "2.0"(altrimenti sollevaValueError). Se ha unresult, restituisci{"id": ..., "ok": True, "result": ...}. Se ha unerror, restituisci{"id": ..., "ok": False, "error": {"code": ..., "message": ...}}. Se non ha nessuno dei due, sollevaValueError.list_tools_request(id)-> la richiesta di scoperta degli strumenti: unbuild_requestcon il metodo"tools/list"eparamsvuoti{}.
Dato che build_request restituisce una stringa, i test la rileggono con json.loads e confrontano il dict, quindi l'ordine delle chiavi non conta. Assicurati che un risultato e un errore facciano entrambi andata e ritorno, che la richiesta di scoperta abbia il metodo giusto, e che un messaggio a cui manca jsonrpc o che non ha né result né error sollevi un errore.
Costruisci e leggi messaggi JSON-RPC 2.0 in stile MCP con il modulo json. build_request(id, method, params) restituisce la stringa JSON di {"jsonrpc": "2.0", "id", "method", "params"}. parse_response(text) legge il testo, pretende jsonrpc == "2.0" (altrimenti solleva ValueError), e restituisce {"id", "ok": True, "result"} per un risultato o {"id", "ok": False, "error": {"code", "message"}} per un errore, sollevando un errore se non ha nessuno dei due. list_tools_request(id) restituisce la richiesta di scoperta tools/list (mandata dopo la stretta di mano) con parametri vuoti.
Hai notato un problema in questa lezione? Segnalalo · Chiedi qualcosa su questa lezione
Questo esercizio si apre presto
Finisci la lezione precedente e questa si sblocca. L'intero corso è gratuito, senza account, e puoi leggere questa lezione subito.
Questo browser blocca i cookie per learn.floati.life, quindi le lezioni che hai finito qui non si possono aprire in ordine. Consenti i cookie per questo sito e ricarica.