Wird geladen
Wird geladen

Prompts in MCP-Servern ermöglichen es dir, vorgefertigte, hochwertige Anweisungen zu definieren, die Clients verwenden können, anstatt ihre eigenen Prompts von Grund auf zu schreiben. Stell sie dir als sorgfältig ausgearbeitete Vorlagen vor, die bessere Ergebnisse liefern als das, was Nutzer sich selbst ausdenken könnten.

Warum Prompts verwenden?

Angenommen, du möchtest, dass Claude ein Dokument in Markdown umformatiert. Ein Nutzer könnte einfach „convert report.pdf to markdown“ eingeben, und das würde gut funktionieren. Aber er würde wahrscheinlich viel bessere Ergebnisse mit einem gründlich getesteten Prompt erzielen, der spezifische Anweisungen zu Formatierung, Struktur und Ausgabeanforderungen enthält.

Der einzeilige Prompt des Nutzers neben einem getesteten Prompt, der eine Dokumentenkonvertierungsrolle, Formatierungsregeln und Analyse-Tags festlegt.

Die zentrale Erkenntnis ist, dass Nutzer diese Aufgaben zwar selbst erledigen können, aber konsistentere und hochwertigere Ergebnisse erzielen, wenn sie Prompts verwenden, die von den Autoren des MCP-Servers sorgfältig entwickelt und getestet wurden.

Wie Prompts funktionieren

Prompts definieren eine Reihe von Nutzer- und Assistenten-Nachrichten, die Clients direkt verwenden können. Wenn ein Client einen Prompt anfordert, gibt dein Server eine Liste von Nachrichten zurück, die direkt an Claude gesendet werden können.

Ein MCP-Server, der einen Prompt namens „format“ enthält, dessen Funktion format_document eine unten gezeigte Liste von Nachrichten zurückgibt.

Die grundlegende Struktur sieht folgendermaßen aus:

  • Definiere Prompts mit dem Decorator @mcp.prompt()
  • Füge für jeden Prompt einen Namen und eine Beschreibung hinzu
  • Gib eine Liste von Nachrichten zurück, die den vollständigen Prompt bilden
  • Diese Prompts sollten hochwertig, gut getestet und relevant für den Zweck deines MCP-Servers sein

Einen Format-Befehl erstellen

So implementierst du einen Prompt zur Dokumentformatierung. Zunächst musst du die grundlegenden Nachrichtentypen importieren:

python
from mcp.server.fastmcp.prompts import base

Definiere anschließend deine Prompt-Funktion:

python
@mcp.prompt(
    name="format",
    description="Rewrites the contents of the document in Markdown format."
)
def format_document(
    doc_id: str = Field(description="Id of the document to format")
) -> list[base.Message]:
    prompt = f"""
Your goal is to reformat a document to be written with markdown syntax.

The id of the document you need to reformat is:

{doc_id}


Add in headers, bullet points, tables, etc as necessary. Feel free to add in extra formatting.
Use the 'edit_document' tool to edit the document. After the document has been reformatted...
"""
    
    return [
        base.UserMessage(prompt)
    ]

Deine Prompts testen

Du kannst Prompts mit dem MCP Inspector testen. Navigiere zum Bereich „Prompts“, wähle deinen Prompt aus und gib alle erforderlichen Parameter an. Der Inspector zeigt dir die generierten Nachrichten an, die an Claude gesendet würden.

MCP Inspector, der den Prompt „format“ mit doc_id outlook.pdf und das Ergebnis von Get Prompt zeigt, eine Nachricht mit der Rolle „user“.

Damit kannst du überprüfen, ob dein Prompt Variablen korrekt interpoliert und die erwartete Nachrichtenstruktur erzeugt, bevor du ihn in einer echten Anwendung einsetzt.

Best Practices

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

  • Konzentriere dich auf Aufgaben, die zentral für den Zweck deines Servers sind
  • Schreibe detaillierte, spezifische Anweisungen statt vager Anfragen
  • Teste deine Prompts gründlich mit unterschiedlichen Eingaben
  • Füge klare Beschreibungen hinzu, damit Nutzer verstehen, was jeder Prompt tut
  • Überlege, wie der Prompt mit den Tools und Ressourcen deines Servers zusammenspielt

Denk daran, dass Prompts einen Mehrwert bieten sollen, den Nutzer sich nicht ohne Weiteres selbst verschaffen könnten – sie sollten deine Expertise in dem Bereich widerspiegeln, den dein MCP-Server abdeckt.