Wird geladen

Ressourcen definieren

Lektion 555 Min.
Wird geladen

Ressourcen in MCP-Servern ermöglichen es dir, Daten für Clients bereitzustellen, ähnlich wie GET-Request-Handler in einem typischen HTTP-Server. Sie sind perfekt für Szenarien, in denen du Informationen abrufen musst, statt Aktionen auszuführen.

Ressourcen verstehen

Stell dir Ressourcen als schreibgeschützte Endpunkte vor, die jede Art von Daten zurückgeben können – Strings, JSON, Binärdateien usw. Du legst einen 'mime_type' fest, um dem Client einen Hinweis darauf zu geben, welche Art von Daten du zurückgibst.

Diagramm eines MCP-Servers, der zwei Ressourcen enthält, die direkte list_docs und die templated fetch_doc, gezeigt im Code unten.

Ressourcen funktionieren, indem sie eine URI (wie eine URL) definieren, die Clients anfordern können. Wenn ein Client Daten benötigt, sendet er eine ReadResourceRequest mit der spezifischen URI, und dein Server antwortet mit einem ReadResourceResult, das die Daten enthält.

Zwei Arten von Ressourcen

Es gibt zwei Haupttypen von Ressourcen, die du erstellen kannst:

  • Direkte Ressourcen – Haben statische URIs, die keine Parameter enthalten (wie „docs://documents")
  • Templated Ressourcen – Enthalten Parameter in ihren URIs, die geparst und an deine Funktion übergeben werden (wie „docs://documents/{doc_id}")

Direkte Ressource ohne URI-Parameter, neben Templated Ressource, deren URI-Parameter das Python-SDK an deine Funktion übergibt.

Bei templated Ressourcen parst das Python-SDK automatisch Parameter aus der URI und übergibt sie als Schlüsselwortargumente an deine Funktion. Die Parameternamen in der URI müssen exakt mit den Parameternamen deiner Funktion übereinstimmen.

Ressourcen erstellen

So implementierst du beide Arten von Ressourcen:

python
@mcp.resource(
    "docs://documents",
    mime_type="application/json"
)
def list_docs() -> list[str]:
    return list(docs.keys())

@mcp.resource(
    "docs://documents/{doc_id}",
    mime_type="text/plain"
)
def fetch_doc(doc_id: str) -> str:
    if doc_id not in docs:
        raise ValueError(f"Doc with id {doc_id} not found")
    return docs[doc_id]

Das MCP-Python-SDK serialisiert automatisch alles, was du zurückgibst. Du musst Daten nicht manuell in JSON-Strings umwandeln – gib einfach Python-Objekte zurück, und das SDK übernimmt die Umwandlung.

Deine Ressourcen testen

Du kannst Ressourcen mit dem MCP Inspector testen. Starte deinen Server mit:

uv run mcp dev mcp_server.py

Verbinde dich dann mit dem Inspector in deinem Browser. Du siehst zwei Bereiche:

  • Resources – Listet deine direkten/statischen Ressourcen auf
  • Resource Templates – Zeigt deine templated Ressourcen

MCP Inspector Resources-Tab: Ressource docs://documents, das fetch_doc-Template und eine JSON-Antwort mit sechs Dokumenten.

Klicke auf eine beliebige Ressource, um sie zu testen. Bei templated Ressourcen musst du Werte für die Parameter angeben. Der Inspector zeigt dir die genaue Antwortstruktur, die dein Client erhalten wird, einschließlich des mime type und der serialisierten Daten.

Praktische Anwendungsfälle

Ressourcen eignen sich ideal für die Implementierung von Funktionen wie Dokumenterwähnungen in Chat-Anwendungen. Wenn ein Nutzer beispielsweise „@" eingibt, um ein Dokument zu erwähnen, könntest du:

  1. Eine direkte Ressource verwenden, um eine Liste aller verfügbaren Dokumente für die Autovervollständigung abzurufen
  2. Eine templated Ressource verwenden, um den Inhalt eines bestimmten Dokuments abzurufen, wenn es erwähnt wird

Dieser Ansatz ermöglicht es dir, Dokumentinhalte vorausschauend in Prompts einzufügen, ohne dass die KI Tools verwenden muss, um die Informationen abzurufen.