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.

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.

Die grundlegende Struktur sieht folgendermaßen aus:
@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ückEinen 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:
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 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:
from mcp.server.fastmcp import FastMCP
from mcp.server.fastmcp.prompts import basePrompts 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.