MCP-Resources für Dateien
So funktionieren Resources
Ein MCP-Server stellt Dateien als Resources mit stabilen URIs bereit. Ein Client kann sie überresources/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:
blob:
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:summary.md an die Unterhaltung an.
Anforderungen
- Gib Dateidaten in
contentszurück. - Gib
mimeTypean; Langdock braucht ihn, um die Datei korrekt zu verarbeiten. - Gib eine aussagekräftige
urian; das letzte Pfadsegment wird zum Dateinamen. - Verwende
blobfür Binärdateien, base64-kodiert ohne Data-URI-Präfix. - Verwende
textfür Plain Text, Markdown, JSON, HTML und andere textbasierte Dateien.
Beispiel-Resource-Output
contents-Array und ergänzt Datei-Zugriffsmetadaten unter files:
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
- Langdock Cookbook - Ausführbare MCP-Rezepte, unter anderem zu Datei-Uploads
- Datei-Input in MCP-Tools - User-Dateien an MCP-Tools übergeben
- Model Context Protocol (MCP) - Übersicht über MCP in Langdock
- Langdock Agent MCP Server - Deine Langdock-Agenten als MCP-Tools bereitstellen
FAQ
Wann sollte ein MCP-Server eine Datei als Resource bereitstellen?
Wann sollte ein MCP-Server eine Datei als Resource bereitstellen?
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.
Was sollte ich prüfen, wenn ein MCP-Datei-Output fehlt?
Was sollte ich prüfen, wenn ein MCP-Datei-Output fehlt?
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.