Wird geladen

Zugriff auf Ressourcen

Lektion 559 Min.
Wird geladen

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

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

Den Ressourcenfluss verstehen

Wenn ein Benutzer in deiner Anwendung etwas wie „Was ist in @..." eingibt, muss das System eine Liste der verfügbaren Ressourcen für die Autovervollständigung abrufen. Der MCP-Client sendet eine ReadResourceRequest an den Server, der mit einer Liste von Dokumentnamen antwortet, die referenziert werden können.

Implementierung des Ressourcenlesens

Die Kernfunktionalität findet in der read_resource-Methode deines MCP-Clients statt. Diese Methode nimmt einen URI-Parameter entgegen, der angibt, welche Ressource vom Server abgerufen werden soll.

Füge zunächst die notwendigen Imports hinzu, um JSON-Parsing und URL-Validierung zu handhaben:

python
import json
from pydantic import AnyUrl

Die Hauptimplementierung stellt eine Anfrage an den MCP-Server 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 Inhaltstypen

Ressourcen können verschiedene Arten von Inhalten zurückgeben, daher musst du den MIME-Typ überprüfen, um die Antwort angemessen zu verarbeiten:

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

Dieser Ansatz stellt sicher, dass JSON-Ressourcen ordnungsgemäß geparst werden, während Klartext-Ressourcen unverändert zurückgegeben werden.

Testen der Implementierung

Sobald die Implementierung abgeschlossen ist, kannst du die Ressourcenfunktionalität testen, indem du deine CLI-Anwendung ausführst. Wenn du „@" gefolgt von einem Ressourcennamen eingibst, wird das System:

  • Verfügbare Ressourcen in einer Autovervollständigungsliste anzeigen
  • Dir ermöglichen, eine Ressource mit den Pfeiltasten und der Leertaste auszuwählen
  • Den Ressourceninhalt direkt in den an Claude gesendeten Prompt einbeziehen

Das bedeutet, dass Claude den Dokumentinhalt sofort erhält, ohne zusätzliche Tool-Aufrufe durchführen zu müssen, was die Interaktion wesentlich effizienter macht.

Wichtige Vorteile

Ressourcen bieten mehrere Vorteile gegenüber Tools für den Zugriff auf statische Informationen:

  • Der Inhalt wird direkt in Prompts einbezogen, was die Latenz reduziert
  • Während des Gesprächs sind keine zusätzlichen API-Aufrufe erforderlich
  • Bessere Benutzererfahrung durch Autovervollständigungsfunktionalität
  • Sauberere Trennung zwischen statischen Daten und dynamischen Operationen

Ressourcen eignen sich am besten für relativ statische Informationen, die du KI-Modellen leicht zugänglich machen möchtest, wie z. B. Dokumentation, Berichte oder Referenzmaterialien.