Claude Academy
Wird geladen

Einen Client implementieren

Lektion 510 Min.

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

Die Client-Architektur verstehen

In den meisten realen Projekten implementierst du entweder einen MCP-Client oder einen MCP-Server - nicht beides. Wir bauen in diesem Projekt beides, nur damit du sehen kannst, wie sie zusammenarbeiten.

Diagramm, das zeigt, dass ein Projekt normalerweise entweder einen MCP-Client oder einen MCP-Server implementiert; unser Projekt implementiert beides und zeigt den MCP-Client innerhalb unseres Servers, der mit dem MCP-Server verbunden ist

Der MCP-Client besteht aus zwei Hauptkomponenten:

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

Diagramm von mcp_client.py, das den MCP Client enthält, eine benutzerdefinierte Klasse, die wir erstellen, um die Nutzung der Session zu vereinfachen, und die Client Session, die eigentliche Verbindung zum MCP-Server

Die Client Session erfordert eine sorgfältige Ressourcenverwaltung - wir müssen Verbindungen ordnungsgemäß bereinigen, wenn wir fertig sind. Deshalb umschließen wir sie mit unserer eigenen Klasse, die die gesamte Bereinigung automatisch übernimmt.

Wie der Client in unsere Anwendung passt

Erinnerst du dich an unser Anwendungsablaufdiagramm? Der Client ist das, was es unserem Code ermöglicht, an zwei entscheidenden Stellen mit dem MCP-Server zu interagieren:

Sequenzdiagramm des Anwendungsablaufs mit Hinweisen, die hervorheben, wo unser CLI-Code den Client verwendet, um eine Liste von Tools zu erhalten, die an Claude übergeben werden, und wo er den Client verwendet, um ein Tool aufzurufen

Unser CLI-Code verwendet den Client, um:

  • Eine Liste verfügbarer Tools zu erhalten, die an Claude gesendet werden
  • Tools auszuführen, wenn Claude sie anfordert

Implementierung der Kernfunktionen des Clients

Wir müssen zwei wesentliche Funktionen implementieren: list_tools() und call_tool().

List Tools Funktion

Diese Funktion ruft alle verfügbaren Tools vom MCP-Server ab:

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

Es ist unkompliziert - wir greifen auf unsere Session zu (die Verbindung zum Server), rufen die eingebaute Methode list_tools() auf und geben die Tools aus dem Ergebnis zurück.

Call Tool Funktion

Diese Funktion führt ein bestimmtes Tool auf dem Server aus:

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)

Wir übergeben den Tool-Namen und die Eingabeparameter (bereitgestellt von Claude) an den Server und geben das Ergebnis zurück.

Testen des Clients

Die Client-Datei enthält unten einen einfachen Test-Harness. Lass ihn eine deiner neuen Methoden aufrufen und das Ergebnis ausgeben:

python
async with MCPClient(
    command="uv", args=["run", "mcp_server.py"]
) as client:
    result = await client.list_tools()
    print(result)

Führe dann die Datei direkt aus, um zu überprüfen, ob alles funktioniert:

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 Beschreibungen und Eingabeschemata.

Alles zusammenfügen

Sobald die Client-Funktionen implementiert sind, kannst du den vollständigen Ablauf testen, indem du deine Hauptanwendung ausführst:

uv run main.py

Versuche zu fragen:

Was ist der Inhalt des Dokuments report.pdf?

Hier ist, was hinter den Kulissen passiert:

  1. Deine Anwendung verwendet den Client, um verfügbare Tools zu erhalten
  2. Diese Tools werden zusammen mit deiner Frage an Claude gesendet
  3. Claude entscheidet sich, das Tool read_doc_contents zu verwenden
  4. Deine Anwendung verwendet den Client, um dieses Tool auszuführen
  5. Das Ergebnis wird an Claude zurückgegeben, der dir dann antwortet

Der Client fungiert als Brücke zwischen deiner Anwendungslogik und der Funktionalität des MCP-Servers und macht es einfach, leistungsstarke Tools in deine KI-Workflows zu integrieren.