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.

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

- 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:

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:
async def list_tools(self) -> list[types.Tool]:
result = await self.session().list_tools()
return result.toolsFür call_tool übergeben wir den Tool-Namen und die Eingabeparameter an den Server:
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:
uv run mcp_client.pyDies 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:
uv run main.pyFrage dann: "Was ist der Inhalt des Dokuments report.pdf?"
Claude wird:
- Die Liste der verfügbaren Tools von deinem Client empfangen
- Entscheiden, das Tool read_doc_contents zu verwenden
- Dein Client wird dieses Tool auf dem MCP-Server ausführen
- 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.