Skip to main content
Die MCP-Spezifikation definiert Resources als Standardweg, damit MCP-Server Dateien und andere Kontextdaten für Clients bereitstellen können. Resources sind application-driven: Die Host-Anwendung entscheidet, wie User sie entdecken, auswählen, lesen, ansehen oder anhängen. In Langdock können MCP-Resources zu regulären Datei-Anhängen werden, die User ansehen, herunterladen und an andere Tools weitergeben können.

MCP-Resources für Dateien

So funktionieren Resources

Ein MCP-Server stellt Dateien als Resources mit stabilen URIs bereit. Ein Client kann sie über resources/list entdecken und den Inhalt anschließend über resources/read abrufen. Entscheidend für Datei-Output ist die resources/read-Antwort. Resource-Inhalte können Text sein:
Oder Binärdaten, base64-kodiert in blob:
Langdock liest diese contents-Einträge und speichert sie als Action-Datei-Outputs. Die uri liefert den Dateinamen, der mimeType teilt Langdock mit, wie die Datei verarbeitet werden soll, und text oder blob enthält den Dateiinhalt.

Demo-Resource-Server

Dieser minimale Server stellt eine Markdown-Datei als MCP-Resource bereit:
Wenn Langdock diese Resource liest, hängt es summary.md an die Unterhaltung an.

Anforderungen

  • Gib Dateidaten in contents zurück.
  • Gib mimeType an; Langdock braucht ihn, um die Datei korrekt zu verarbeiten.
  • Gib eine aussagekräftige uri an; das letzte Pfadsegment wird zum Dateinamen.
  • Verwende blob für Binärdateien, base64-kodiert ohne Data-URI-Präfix.
  • Verwende text für Plain Text, Markdown, JSON, HTML und andere textbasierte Dateien.

Beispiel-Resource-Output

Langdock speichert das als Anhang. Das Tool-Ergebnis behält das ursprüngliche contents-Array und ergänzt Datei-Zugriffsmetadaten unter files:
Der text- oder blob-Wert bleibt im Tool-Ergebnis, auch nachdem Langdock die Datei als Anhang gespeichert hat. Der Resource-Inhalt zählt deshalb zum Kontextfenster des Modells. Bei Binärdateien kann der base64-blob einen großen Teil des verfügbaren Kontexts belegen. Halte Resource-Inhalte klein, damit dem Modell genug Platz für den Rest der Unterhaltung bleibt.

Verwandte Dokumentation

FAQ

Stelle eine Datei als Resource bereit, wenn das Ergebnis besser als herunterladbare Datei funktioniert, etwa ein generiertes Dokument, eine umgewandelte Datei, ein Report, ein Export oder ein binäres Asset. Langdock erstellt Anhänge aus Resources. Dateien in regulären MCP-Tool-Ergebnissen werden nicht zu Anhängen.
Prüfe, ob der MCP-Server die Datei als unterstützte Resource bereitstellt, die erwarteten Metadaten zurückgibt und ein Format verwendet, das Langdock in einen Anhang umwandeln kann. Bestätige außerdem, dass das Lesen der Resource erfolgreich durchgelaufen ist.