Wird geladen

Implementierung eines Clients

Lektion 5310 Min.
Wird geladen

Jetzt, da unser MCP-Server funktioniert, ist es an der Zeit, die Client-Seite zu entwickeln. Der Client ist das, was es unserer Anwendung ermöglicht, mit dem MCP-Server zu kommunizieren und auf dessen Funktionalität zuzugreifen.

Die Client-Architektur verstehen

Bevor wir in den Code eintauchen, lass uns einen wichtigen Punkt zu MCP-Projekten klären. Normalerweise würdest du entweder einen MCP-Client oder einen MCP-Server implementieren - nicht beides. Wir bauen in diesem Projekt beides, nur damit du sehen kannst, wie sie zusammenarbeiten.

Diagramm unseres Servers, der den MCP-Client enthält, der sich in beide Richtungen mit einem separaten MCP-Server verbindet.

Der MCP-Client besteht aus zwei Hauptkomponenten, die zusammenarbeiten:

Diagramm von mcp_client.py, das den MCP Client und die Client Session enthält, die sich mit einem separaten MCP-Server verbindet.

  • MCP Client - Eine eigene Klasse, die wir erstellen, um die Nutzung der Session zu vereinfachen
  • Client Session - Die eigentliche Verbindung zum Server (Teil des MCP Python SDK)

Die Client Session übernimmt die Low-Level-Kommunikation, erfordert aber eine sorgfältige Bereinigung der Ressourcen, wenn dein Programm heruntergefahren wird. Deshalb kapseln wir sie in unserer eigenen Klasse - um diese Bereinigung automatisch zu verwalten.

Wie der Client in unsere Anwendung passt

Erinnerst du dich an unser Anwendungsablaufdiagramm? Der Client spielt in zwei entscheidenden Momenten eine wichtige Rolle:

Sequenzdiagramm des Anwendungsablaufs, das hervorhebt, wo unser CLI-Code den Client verwendet, um Tools aufzulisten und ein Tool aufzurufen.

Unser CLI-Code verwendet den Client, um:

  • eine Liste der verfügbaren Tools abzurufen, die an Claude gesendet werden
  • Tools auszuführen, wenn Claude sie anfordert

Implementierung der zentralen Client-Funktionen

Lass uns die zwei wesentlichen Funktionen implementieren: list_tools und call_tool.

Für list_tools müssen wir eine Verbindung zu unserer Session herstellen und die verfügbaren Tools anfordern:

python
async def list_tools(self) -> list[types.Tool]:
    result = await self.session().list_tools()
    return result.tools

Für call_tool übergeben wir den Tool-Namen und die Eingabeparameter an den Server:

python
async def call_tool(
    self, tool_name: str, tool_input: dict
) -> types.CallToolResult | None:
    return await self.session().call_tool(tool_name, tool_input)

Das war's! Die Session übernimmt für uns alle komplexen Kommunikationsdetails.

Testen des Clients

Die Client-Datei enthält unten einen einfachen Test-Harness. Du kannst ihn direkt ausführen, um zu überprüfen, ob alles funktioniert:

bash
uv run mcp_client.py

Dies verbindet sich mit deinem MCP-Server und gibt die verfügbaren Tools aus. Du solltest eine Ausgabe sehen, die deine Tool-Definitionen zeigt, einschließlich Namen, Beschreibungen und Eingabeschemata.

Wichtige Schema-Unterschiede

Hier ist ein Stolperstein, über den du Bescheid wissen musst: MCP-Tool-Definitionen stimmen nicht genau mit dem überein, was Claude erwartet. Die MCP-Spezifikation hat ihr eigenes Format für Tool-Schemata, das sich leicht von dem unterscheidet, was Bedrock benötigt.

Keine Sorge - im Projekt gibt es bereits Code, der diese Konvertierung automatisch übernimmt. Die Funktion to_bedrock_tools in core/bedrock.py übersetzt MCP-Tool-Definitionen in das Format, das Claude versteht.

Testen mit Claude

Jetzt, da sowohl der Server als auch der Client funktionieren, kannst du den kompletten Ablauf testen. Versuche, deine Hauptanwendung auszuführen und Claude zu bitten, ein Dokument zu lesen:

bash
uv run main.py

Frage dann: "Was ist der Inhalt des Dokuments report.pdf?"

Claude wird:

  1. Die Liste der verfügbaren Tools von deinem Client empfangen
  2. Entscheiden, das Tool read_doc_contents zu verwenden
  3. Dein Client wird dieses Tool auf dem MCP-Server ausführen
  4. Claude wird den Dokumentinhalt empfangen und antworten

Der Client fungiert als Brücke zwischen deinem Anwendungscode und dem MCP-Server und macht es einfach, die Server-Funktionalität für Claude und andere Teile deines Systems verfügbar zu machen.