Claude Academy
Wird geladen

Prompts definieren

Lektion 579 Min.

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. Betrachte sie als sorgfältig erstellte Vorlagen, die bessere Ergebnisse liefern als das, was Nutzer selbst entwickeln 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 ordentliche Ergebnisse erhalten. Aber er würde wahrscheinlich eine viel bessere Ausgabe erhalten, wenn er einen gründlich getesteten, spezialisierten Prompt verwenden würde, den du speziell für die Dokumentformatierung entwickelt hast.

Die zentrale Erkenntnis ist, dass Nutzer diese Aufgaben zwar selbst erledigen können, aber bessere 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.

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]:
    # Gib 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.

Der Inspector zeigt dir genau, welche Nachrichten an Claude gesendet werden, einschließlich der Art und Weise, wie 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 gut gestalteten 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 relevant für den Gesamtzweck deines MCP-Servers sein. In unserem Dokumentenverwaltungsbeispiel sind Formatierungs-Prompts sinnvoll, da sich der Server auf Dokumentoperationen spezialisiert.