Des outils via MCP (Model Context Protocol)
Dès que ton appli a plus d'un outil, chaque fournisseur de modèle invente sa propre forme JSON pour les appeler, et tu finis par écrire un adaptateur par fournisseur. Le Model Context Protocol (MCP) est le standard ouvert qui règle ça. C'est un protocole de communication JSON-RPC 2.0 pour exposer des outils (des fonctions que le modèle peut appeler), des ressources (des données qu'il peut lire) et des prompts à n'importe quel client de modèle. Écris un serveur MCP une fois et n'importe quel client compatible MCP (un assistant d'IDE, une appli de bureau, un agent) peut l'utiliser.
Chaque message est en JSON-RPC 2.0, une enveloppe minuscule et fixe. Une requête porte toujours quatre clés :
{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
"params": {"name": "add", "arguments": {"a": 2, "b": 3}}}L'id relie une réponse à sa requête. Le serveur répond par une réponse qui reprend le même id et porte soit un objet result, soit un objet error, jamais les deux :
{"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"}}Les codes négatifs sont ceux du JSON-RPC standard : -32601 veut dire « méthode introuvable », -32602 « paramètres invalides », et ainsi de suite. Un résultat de tools/call a toujours cette forme : une liste content de blocs (texte, images, etc.) plus isError. Un outil qui a tourné mais échoué (un mauvais nom de ville, par exemple) répond avec isError: true dans un résultat normal, pour que le modèle puisse lire l'échec ; l'objet error de JSON-RPC sert aux problèmes de protocole, comme une méthode inconnue.
Une session commence par une poignée de main : le client envoie une requête initialize (sa version du protocole, ses capacités et son nom), le serveur répond avec ses propres capacités, et le client confirme avec une notification notifications/initialized (un message sans id, car personne n'y répond). Ce n'est qu'ensuite que le client découvre les outils en appelant tools/list avec des paramètres vides ; le serveur renvoie la liste des descriptions d'outils.
Un vrai serveur MCP tourne via stdio ou HTTP et branche tout ça dans le SDK ; ici on construit et on lit les messages avec le module standard json pour rendre le format concret. Tu écris trois fonctions.
build_request(id, method, params)-> une chaîne JSON pour l'enveloppe{"jsonrpc": "2.0", "id": id, "method": method, "params": params}. Utilisejson.dumps.parse_response(text)-> lis le texte avecjson.loads, exigejsonrpc == "2.0"(lèveValueErrorsinon). S'il a unresult, renvoie{"id": ..., "ok": True, "result": ...}. S'il a uneerror, renvoie{"id": ..., "ok": False, "error": {"code": ..., "message": ...}}. S'il n'a ni l'un ni l'autre, lèveValueError.list_tools_request(id)-> la requête de découverte des outils : unbuild_requestavec la méthode"tools/list"et desparamsvides{}.
Comme build_request renvoie une chaîne, les tests la relisent avec json.loads et comparent le dict, donc l'ordre des clés n'a pas d'importance. Vérifie qu'un résultat et une erreur font tous deux l'aller-retour, que la requête de découverte a la bonne méthode, et qu'un message sans jsonrpc ou sans result ni error lève une exception.
Construis et lis des messages JSON-RPC 2.0 façon MCP avec le module json. build_request(id, method, params) renvoie la chaîne JSON de {"jsonrpc": "2.0", "id", "method", "params"}. parse_response(text) lit le texte, exige jsonrpc == "2.0" (sinon lève ValueError), et renvoie {"id", "ok": True, "result"} pour un résultat ou {"id", "ok": False, "error": {"code", "message"}} pour une erreur, en levant une exception s'il n'a ni l'un ni l'autre. list_tools_request(id) renvoie la requête de découverte tools/list (envoyée après la poignée de main) avec des paramètres vides.
Tu as repéré un problème dans cette leçon ? Signale-le · Pose une question sur cette leçon
Cet exercice s'ouvre bientôt
Termine la leçon précédente pour débloquer celle-ci. Tout le cours est gratuit, aucun compte n'est requis, et tu peux lire cette leçon dès maintenant.
Ce navigateur bloque les cookies pour learn.floati.life, donc les leçons que tu as terminées ici ne peuvent pas s'ouvrir dans l'ordre. Autorise les cookies pour ce site et recharge la page.