Accessing resources

📝 Lernnotizen: MCP Client - Ressourcen lesen

Kontext:

• Der MCP Server stellt Ressourcen bereit.
• Der MCP Client muss eine Funktion implementieren, um diese Ressourcen anzufordern und zu verarbeiten.
• Diese Funktion wird von anderen Teilen der Anwendung genutzt (z. B. um Dokumentinhalte für Prompts zu laden).

Kernkonzepte der Funktion read_resource:

• Ziel: Ein spezifisches Resource von der MCP Server abrufen und dessen Inhalt basierend auf dem MIME-Typ parsen und zurückgeben.
• Parameter: Die Funktion benötigt einen URI (Uniform Resource Identifier) des zu lesenden Resources.
• Abruf des Inhalts:
• Es wird eine asynchrone Anfrage (await self. session. read_resource) an den Server gesendet.
• Der Rückgabewert (result) enthält die Antwort.
• Der eigentliche Inhalt wird aus result. contents[0] extrahiert.
• Datenverarbeitung (MIME-Typ-Prüfung):
• Der mime_type des Resources bestimmt, wie der Inhalt verarbeitet wird.
• Wenn MIME-Typ application/json ist: Der Textinhalt wird mithilfe von json. loads() als JSON-Objekt geparsed und zurückgegeben.
• **Andernfalls (z. B. Textdokument):** Der Textinhalt wird direkt als einfacher Text zurückgegeben, ohne Parsing.
• Wichtige Imports:
• json (für JSON-Parsing).
• AnyURL (aus PyDenotik, zur Typisierung des URI-Inputs).

Zusammenfassung des Workflows:

• Client fordert Resource über URI an.
• Server liefert Inhalt und MIME-Typ.
• Client prüft MIME-Typ.
• Client parst (JSON) oder gibt Rohdaten (Text) zurück.
• Die Anwendung nutzt den zurückgegeben Inhalt (z. B. zur Prompt-Generierung).

Takeaways

• Der MCP Client muss Ressourcen über einen URI vom MCP Server abrufen und verarbeiten.
• Die Funktion read_resource sendet eine asynchrone Anfrage (await self. session. read_resource) und extrahiert den Inhalt aus dem Ergebnis.
• Die Verarbeitung des Inhalts hängt vom MIME-Typ ab.
• Bei MIME-Typ application/json wird der Textinhalt mit json. loads() als Objekt geparsed.
• Andere MIME-Typen (z. B. Textdokument) werden direkt als roher Text zurückgegeben.