Wird geladen
Wird geladen

MCP-Server können Prompts definieren - vorgefertigte, hochwertige Anweisungen, die Clients verwenden können, anstatt eigene Prompts von Grund auf zu schreiben. Stell dir Prompts als sorgfältig gestaltete Vorlagen vor, die bessere Ergebnisse liefern als das, was Nutzer möglicherweise selbst schreiben würden.

Warum Prompts verwenden?

Angenommen, du möchtest, dass Claude ein Dokument in Markdown umformatiert. Du könntest einfach "Konvertiere report.pdf zu Markdown" eingeben, und das würde gut funktionieren. Aber du würdest wahrscheinlich viel bessere Ergebnisse mit einem gründlich getesteten, detaillierten Prompt erzielen, der Randfälle abdeckt und spezifische Formatierungsanweisungen gibt.

Nebeneinander: der einzeilige Prompt des Nutzers gegenüber einem langen Server-Prompt, der Claude als Spezialisten für die Dokumentkonvertierung einsetzt.

Die Idee ist einfach: Als MCP-Server-Entwickler können wir Zeit investieren, um wirklich gute Prompts zu erstellen und zu testen, und sie dann allen zur Verfügung stellen, die unseren Server nutzen. Nutzer erhalten bessere Ergebnisse, ohne selbst zu Experten im Prompt-Engineering werden zu müssen.

Einen Prompt definieren

Prompts verwenden ein ähnliches Decorator-Muster wie Tools und Ressourcen. Hier ist die grundlegende Struktur:

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]:
    # Gib eine Liste von Nachrichten zurück

Die Funktion gibt eine Liste von Nachrichten zurück, die direkt an Claude gesendet werden können. Dies ermöglicht es dir, bei Bedarf komplexe Prompts mit mehreren Nutzer- und Assistenten-Nachrichten zu erstellen.

Erstellen des Format-Prompts

Für unseren Dokumentserver erstellen wir einen Prompt, der Dokumente in Markdown umformatiert. Der Prompt muss:

  • Eine Dokument-ID als Eingabe entgegennehmen
  • Das Tool read_doc_contents verwenden, um das Dokument abzurufen
  • Es mit korrekter Markdown-Syntax neu formatieren
  • Die Änderungen zurück in das Dokument speichern

So sieht die Implementierung aus:

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)
    ]

Den Prompt testen

Sobald du deinen Prompt definiert hast, kannst du ihn mit dem MCP Inspector testen. Navigiere zum Tab „Prompts“, wähle deinen Prompt aus und gib die erforderlichen Parameter an.

MCP Inspector Prompts-Tab: der „format“-Prompt mit doc_id auf outlook.pdf gesetzt, und die generierte Nutzernachricht.

Der Inspector zeigt dir die generierten Nachrichten, die an Claude gesendet würden. Du kannst überprüfen, ob die Parameterinterpolation korrekt funktioniert und ob dein Prompt alle notwendigen Anweisungen enthält.

Wesentliche Vorteile

  • Qualitätskontrolle - Server-Autoren können Prompts testen und verfeinern, bevor Nutzer sie sehen
  • Konsistenz - Alle erhalten den gleichen hochwertigen Prompt, anstatt zu improvisieren
  • Spezialisierung - Prompts können auf die spezifische Domäne und die Fähigkeiten deines Servers zugeschnitten werden
  • Wiederverwendbarkeit - Mehrere Client-Anwendungen können dieselben gut gestalteten Prompts verwenden

Denke daran, das Basismodul für Nachrichtentypen zu importieren:

python
from mcp.server.fastmcp.prompts import base

Prompts sind besonders wertvoll, wenn dein MCP-Server einen spezifischen Schwerpunktbereich hat - wie Dokumentenverwaltung, Datenanalyse oder Code-Generierung. Du kannst Nutzern bewährte Prompts bereitstellen, die die Tools deines Servers effektiv nutzen.