Wird geladen

Auf Ressourcen zugreifen

Lektion 569 Min.
Wird geladen

Ressourcen in MCP ermöglichen es deinem Server, Daten bereitzustellen, die direkt in Prompts einbezogen werden können, anstatt Tool-Aufrufe zu erfordern, um auf Informationen zuzugreifen. Dies schafft eine effizientere Möglichkeit, KI-Modellen wie Claude Kontext bereitzustellen.

Den Ressourcenfluss verstehen

Um die Autovervollständigung zu füllen, liest der MCP-Client docs://documents vom MCP-Server und gibt Dokumentnamen an unseren Code zurück.

Wenn ein Nutzer auf Ressourceninhalte zugreifen möchte, funktioniert der Ablauf so:

  • Der Nutzer fragt nach Informationen zu einer Ressource (wie „@report.pdf“)
  • Dein Code benötigt eine Liste von Dokumentnamen für die Autovervollständigung
  • Der MCP-Client sendet eine ReadResourceRequest an den MCP-Server
  • Der Server antwortet mit einem ReadResourceResult, das die Ressourcendaten enthält
  • Dein Code kann diese Daten dann direkt in Prompts einfügen

Implementierung des Ressourcen-Lesens

Um Ressourcen von deinem MCP-Client zu lesen, musst du eine read_resource-Funktion implementieren. Füge zuerst die notwendigen Imports hinzu:

python
import json
from pydantic import AnyUrl

Die Kernfunktion stellt eine Anfrage an deine MCP-Session und verarbeitet die Antwort:

python
async def read_resource(self, uri: str) -> Any:
    result = await self.session().read_resource(AnyUrl(uri))
    resource = result.contents[0]

Umgang mit verschiedenen Ressourcentypen

Ressourcen können unterschiedliche Inhaltstypen zurückgeben, daher musst du den MIME-Typ überprüfen und entsprechend parsen:

python
if isinstance(resource, types.TextResourceContents):
    if resource.mimeType == "application/json":
        return json.loads(resource.text)
    
    return resource.text

Dieser Ansatz deckt zwei Hauptszenarien ab:

  • JSON-Ressourcen, die geparst werden müssen
  • Klartext-Ressourcen, die unverändert zurückgegeben werden können

Testen des Ressourcenzugriffs

MCP Inspector Resources Tab: Das Lesen von docs://documents/report.pdf gibt den mimeType „text/plain“ und den Berichtstext zurück.

Du kannst überprüfen, ob deine Ressourcenimplementierung funktioniert, indem du sie in deiner Anwendung testest. Wenn du „@“ gefolgt von einem Ressourcennamen eingibst, solltest du eine Autovervollständigungsliste der verfügbaren Ressourcen sehen. Die Auswahl einer Ressource fügt ihren Inhalt direkt in deinen Prompt ein.

Der entscheidende Vorteil dieses Ansatzes ist die Effizienz - Claude erhält den Dokumentinhalt sofort, ohne zusätzliche Tool-Aufrufe machen zu müssen, um auf die Informationen zuzugreifen.

Ressourcen- vs. Tool-Nutzung

Ressourcen sind besonders nützlich, wenn:

  • Du statische oder halbstatische Inhalte hast, die häufig referenziert werden
  • Du die Anzahl der API-Aufrufe reduzieren möchtest
  • Der Inhalt sofort im Prompt-Kontext verfügbar sein sollte

Dies unterscheidet sich von Tools, die besser für dynamische Operationen geeignet sind oder wenn die KI basierend auf dem Gesprächskontext entscheiden soll, ob auf bestimmte Informationen zugegriffen wird.