Lehrplan Lektion 139 von 250 · Strukturierte Ausgaben & Funktions-/Tool-Aufrufe
Strukturierte Ausgaben & Funktions-/Tool-Aufrufe

Tools über MCP (Model Context Protocol)

Sobald deine App mehr als ein Tool hat, erfindet jeder Modellanbieter seine eigene JSON-Form, um sie aufzurufen, und am Ende schreibst du einen Adapter pro Anbieter. Das Model Context Protocol (MCP) ist der offene Standard, der das behebt. Es ist ein JSON-RPC 2.0-Übertragungsprotokoll, um Tools (Funktionen, die das Modell aufrufen kann), Ressourcen (Daten, die es lesen kann) und Prompts jedem Modell-Client anzubieten. Schreib einmal einen MCP-Server, und jeder MCP-fähige Client (ein IDE-Assistent, eine Desktop-App, ein Agent) kann ihn benutzen.

Jede Nachricht ist JSON-RPC 2.0, ein winziger, fester Umschlag. Eine Anfrage trägt immer vier Schlüssel:

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

Die id verbindet eine Antwort mit ihrer Anfrage. Der Server antwortet mit einer Response, die dieselbe id wiederholt und entweder ein result oder ein error-Objekt trägt, nie beides:

{"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 negativen Codes sind Standard-JSON-RPC: -32601 ist "Methode nicht gefunden", -32602 ist "ungültige Parameter" und so weiter. Ein tools/call-Ergebnis hat immer diese Form: eine content-Liste von Blöcken (Text, Bilder und so weiter) plus isError. Ein Tool, das lief, aber scheiterte (etwa ein falscher Städtename), antwortet mit isError: true in einem normalen Ergebnis, damit das Modell den Fehler lesen kann; das JSON-RPC-Objekt error ist für Protokollprobleme wie eine unbekannte Methode.

Eine Sitzung beginnt mit einem Handshake: Der Client schickt eine initialize-Anfrage (seine Protokollversion, seine Fähigkeiten und seinen Namen), der Server antwortet mit seinen eigenen Fähigkeiten, und der Client bestätigt mit einer Benachrichtigung notifications/initialized (eine Nachricht ohne id, weil niemand darauf antwortet). Erst dann entdeckt der Client die Tools, indem er tools/list mit leeren Parametern aufruft; der Server gibt die Liste der Tool-Beschreibungen zurück.

Ein echter MCP-Server läuft über stdio oder HTTP und verdrahtet das im SDK; hier bauen und parsen wir die Nachrichten mit dem Standardmodul json, damit das Übertragungsformat greifbar wird. Du schreibst drei Funktionen.

  • build_request(id, method, params) -> ein JSON-String für den Umschlag {"jsonrpc": "2.0", "id": id, "method": method, "params": params}. Benutze json.dumps.
  • parse_response(text) -> den Text mit json.loads lesen, jsonrpc == "2.0" verlangen (sonst ValueError werfen). Hat er ein result, gib {"id": ..., "ok": True, "result": ...} zurück. Hat er einen error, gib {"id": ..., "ok": False, "error": {"code": ..., "message": ...}} zurück. Hat er keins von beiden, wirf ValueError.
  • list_tools_request(id) -> die Anfrage zur Tool-Entdeckung: ein build_request mit der Methode "tools/list" und leeren params {}.

Weil build_request einen String zurückgibt, parsen die Tests ihn mit json.loads zurück und vergleichen das Dict, also spielt die Reihenfolge der Schlüssel keine Rolle. Sorg dafür, dass ein Ergebnis und ein Fehler beide den Hin- und Rückweg überstehen, die Entdeckungsanfrage die richtige Methode hat und eine Nachricht ohne jsonrpc oder ohne result und ohne error eine Ausnahme wirft.

Du bist dran

Erstelle und analysiere MCP-style JSON-RPC 2.0 Nachrichten mit dem json Modul. build_request(id, method, params) gibt den JSON String für {"jsonrpc": "2.0", "id", "method", "params"} zurück. parse_response(text) lädt den Text, benötigt jsonrpc == "2.0" (sonst ValueError auslösen) und gibt {"id", "ok": True, "result"} für ein Ergebnis oder {"id", "ok": False, "error": {"code", "message"}} für einen Fehler zurück, wobei es ausgelöst wird, wenn es keines von beiden hat. list_tools_request(id) gibt die tools/list Discovery Anfrage zurück (gesendet nach dem Handshake) mit leeren params.

Ein Problem in dieser Lektion entdeckt? Melde es · Frage zu dieser Lektion

Diese Übung öffnet bald

Beende die vorherige Lektion, damit diese freigeschaltet wird. Der ganze Kurs ist kostenlos, kein Konto erforderlich, und du kannst diese Lektion jetzt direkt lesen.