Wird geladen
Wird geladen

Prompts in MCP definieren eine Reihe von User- und Assistant-Nachrichten, die vom Client verwendet werden können. Diese Prompts sollten hochwertig, gut getestet und relevant für den Gesamtzweck des MCP-Servers sein.

MCP-Server-Code, der einen Prompt namens „format“ definiert, der den Inhalt eines Dokuments im Markdown-Format umschreibt.

Implementierung von List Prompts

Der erste Schritt besteht darin, die Methode list_prompts in deinem MCP-Client zu implementieren. Diese Methode ruft alle verfügbaren Prompts vom Server ab:

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

Diese einfache Implementierung ruft die list_prompts-Methode der Session auf und gibt das Prompts-Array aus dem Ergebnis zurück.

Abrufen einzelner Prompts

Die Methode get_prompt ruft einen bestimmten Prompt mit interpolierten Argumenten ab. Wenn du einen Prompt anforderst, gibst du Argumente an, die als Keyword-Argumente an die Prompt-Funktion übergeben werden:

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 die Nachrichten aus dem Ergebnis zurück, die eine Konversation bilden, die direkt an Claude weitergegeben werden kann.

Wie Prompt-Argumente funktionieren

Wenn du auf der Serverseite eine Prompt-Funktion definierst, kann sie Parameter akzeptieren. Ein Prompt zur Dokumentformatierung könnte beispielsweise einen doc_id-Parameter erwarten:

python
def format_document(doc_id: str):
    # Die doc_id wird in den Prompt eingefügt

Wenn der Client get_prompt aufruft, sollte das Argumente-Dictionary die erwarteten Schlüssel enthalten. Der MCP-Server übergibt diese als Keyword-Argumente an die Prompt-Funktion, wodurch dynamische Inhalte in die Prompt-Vorlage eingefügt werden können.

Testen von Prompts in der CLI

Sobald die Implementierung abgeschlossen ist, kannst du Prompts über die Kommandozeilenschnittstelle testen. Wenn du einen Schrägstrich eingibst, erscheinen verfügbare Prompts als Befehle. Die Auswahl eines Prompts kann dich auffordern, aus verfügbaren Optionen (wie Dokument-IDs) zu wählen, und anschließend wird der vollständige Prompt an Claude gesendet.

Terminal, das uv run main.py ausführt, mit eingegebenem „/format plan.md“ und einer Datei-Autovervollständigungsliste mit hervorgehobenem plan.md.

Der Workflow sieht folgendermaßen aus:

  1. Der User wählt einen Prompt aus (wie „format“)
  2. Das System fordert die erforderlichen Argumente an (wie etwa, welches Dokument formatiert werden soll)
  3. Der Prompt wird mit den interpolierten Werten an Claude gesendet
  4. Claude kann dann Tools verwenden, um zusätzliche Daten abzurufen und die Aufgabe zu erledigen

Terminal-Markdown mit einer Ressourcentabellenzeile „Development Team 5 FTE Phases 1-5“ und einem Abschnitt Risk Management.

Best Practices für Prompts

Beim Erstellen von Prompts für deinen MCP-Server:

  • Mache sie relevant für den Zweck deines Servers
  • Teste sie gründlich vor der Bereitstellung
  • Verwende klare, spezifische Anweisungen
  • Gestalte sie so, dass sie gut mit deinen verfügbaren Tools zusammenarbeiten
  • Überlege, welche Argumente Nutzer bereitstellen müssen

Prompts überbrücken die Lücke zwischen vordefinierter Funktionalität und dynamischen Nutzerbedürfnissen und geben Claude strukturierte Ausgangspunkte für komplexe Aufgaben, während gleichzeitig durch Parametrisierung Flexibilität erhalten bleibt.