Wird geladen
Wird geladen

Prompts in MCP-Servern ermöglichen es dir, vorgefertigte, hochwertige Anweisungen zu definieren, die Clients nutzen können, anstatt eigene Prompts von Grund auf zu schreiben. Betrachte sie als sorgfältig ausgearbeitete Vorlagen, die bessere Ergebnisse liefern als das, was Nutzer selbst zusammenstellen könnten.

Warum Prompts verwenden?

Nehmen wir an, du möchtest, dass Claude ein Dokument in Markdown umformatiert. Ein Nutzer könnte einfach "convert report.pdf to markdown" eingeben und ein ordentliches Ergebnis erhalten. Aber wahrscheinlich würden sie eine deutlich bessere Ausgabe erhalten, wenn sie einen gründlich getesteten, spezialisierten Prompt verwenden würden, den du speziell für die Dokumentenformatierung entwickelt hast.

Der Prompt des Nutzers "Convert report.pdf to markdown" neben einem langen Prompt, der Claude als Spezialisten für Dokumentenkonvertierung darstellt.

Die entscheidende Erkenntnis ist: Während Nutzer diese Aufgaben auch allein bewältigen können, erzielen sie bessere Ergebnisse, 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 Assistentennachrichten, 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.

Nutzerprompt "Convert report.pdf to markdown" neben einem langen Server-Prompt, der eine Rolle, Markdown-Regeln und Beispielausgabe vorgibt.

Die grundlegende Struktur sieht folgendermaßen aus:

python
@mcp.prompt(
    name="format",
    description="Rewrites the contents of a document in Markdown format",
)
def format_document(
    doc_id: str = Field(description="Id of the document to format"),
) -> list[base.Message]:
    # Gibt eine Liste von Nachrichten zurück

Einen Format-Befehl erstellen

Hier ist ein praktisches Beispiel. Wir erstellen einen Format-Befehl, mit dem Nutzer /format doc_id eingeben können, um ein beliebiges Dokument in Markdown-Syntax umzuformatieren.

Die Prompt-Implementierung enthält detaillierte Anweisungen für Claude:

python
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 structure.
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 Tab "Prompts", wähle deinen Prompt aus und gib alle erforderlichen Parameter an.

MCP Inspector mit dem "format"-Prompt, doc_id auf "outlook.pdf" gesetzt und der von Get Prompt zurückgegebenen Nutzernachricht.

Der Inspector zeigt dir genau, welche Nachrichten an Claude gesendet werden, einschließlich wie etwaige Parameter in den Prompt-Text eingefügt werden.

Wichtige Vorteile

  • Qualitätskontrolle - Du kannst Prompts testen und verfeinern, bevor Nutzer sie sehen
  • Konsistenz - Nutzer erhalten jedes Mal zuverlässige Ergebnisse
  • Spezialisierung - Prompts können auf die spezifische Domäne deines Servers zugeschnitten werden
  • Wiederverwendbarkeit - Mehrere Clients können dieselben sorgfältig erstellten Prompts verwenden

Implementierungsdetails

Vergiss nicht, das Basismodul für Nachrichtentypen zu importieren:

python
from mcp.server.fastmcp import FastMCP
from mcp.server.fastmcp.prompts import base

Prompts sollten hochwertig, gut getestet und für den Gesamtzweck deines MCP-Servers relevant sein. In unserem Beispiel zur Dokumentenverwaltung ergeben Formatierungs-Prompts durchaus Sinn, da sich der Server auf Dokumentenoperationen spezialisiert.