Wird geladen
Wird geladen

Der letzte Schritt beim Erstellen unseres MCP-Clients ist die Implementierung der Prompt-Funktionalität. Dies ermöglicht es uns, alle verfügbaren Prompts vom Server aufzulisten und bestimmte Prompts mit darin interpolierten Variablen abzurufen.

Implementierung von List Prompts

Die Methode list_prompts ist unkompliziert. Wir rufen die List-Prompts-Methode der Session auf und geben die Prompts zurück:

python
async def list_prompts(self) -> list[types.Prompt]:
    result = await self.session().list_prompts()
    return result.prompts

Abrufen einzelner Prompts

Die Methode get_prompt ist interessanter, weil sie die Interpolation von Argumenten handhabt. Wenn wir einen bestimmten Prompt anfordern, übergeben wir Argumente, die in die Prompt-Funktion eingefügt werden. Wenn unser Server beispielsweise einen „format“-Prompt hat, der einen doc_id-Parameter erwartet, wird dieser Wert durchgereicht und in den tatsächlichen Prompt-Text interpoliert.

python
async def get_prompt(self, prompt_name, args: dict[str, str]):
    result = await self.session().get_prompt(prompt_name, args)
    return result.messages

Die Methode gibt Nachrichten zurück, die eine Konversation bilden, die direkt in Claude eingespeist werden kann.

Prompts in Aktion testen

Wenn du den Client ausführst und einen Schrägstrich eingibst, siehst du verfügbare Prompts als Befehle. Die Auswahl eines Prompts wie „format“ fordert dich auf, aus verfügbaren Dokumenten auszuwählen. Das System macht dann Folgendes:

  • Nimmt den Prompt mit der interpolierten Dokument-ID
  • Übergibt ihn direkt als Benutzernachricht an Claude
  • Claude erhält sowohl die Anweisungen als auch die Dokument-ID
  • Claude verwendet verfügbare Tools, um den Dokumentinhalt abzurufen
  • Claude antwortet mit dem neu formatierten Ergebnis

Die Eingabe eines Schrägstrichs im Client listet „/format“ auf, was den Inhalt des Dokuments im Markdown-Format neu schreibt.

Wie Prompts funktionieren

Prompts definieren eine Reihe von Benutzer- und Assistenten-Nachrichten, die vom Client verwendet werden können. Diese Prompts sollten von hoher Qualität, gut getestet und relevant für den Gesamtzweck deines MCP-Servers sein.

MCP-Server-Code: @mcp.prompt benennt einen „format“-Prompt, der ein Dokument in Markdown neu schreibt, mit einer format_document-Funktion.

Der Workflow sieht so aus:

  1. Schreibe und evaluiere einen Prompt, der für den Zweck deines MCP-Servers relevant ist
  2. Definiere den Prompt innerhalb deines MCP-Servers mithilfe des Dekorators @mcp.prompt
  3. Dein Client kann diesen Prompt jederzeit anfordern
  4. Stelle beim Anfordern des Prompts Argumente bereit, die als Schlüsselwortargumente an die Prompt-Funktion übergeben werden
  5. Die Funktion verwendet diese Argumente, um den Prompt-Inhalt anzupassen

Dieses System erzeugt wiederverwendbare, parametrisierte Prompts, die über verschiedene Clients und Anwendungsfälle hinweg geteilt werden können, was deinen MCP-Server vielseitiger und leistungsfähiger macht.