Wird geladen
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 eignen sich perfekt für Szenarien, in denen du Informationen abrufen musst, anstatt Aktionen auszuführen.

Ressourcen anhand eines Beispiels verstehen

Angenommen, du möchtest eine Funktion zur Dokumenterwähnung entwickeln, bei der Nutzer @dokumentname eingeben können, um auf Dateien zu verweisen. Dies erfordert zwei Operationen:

  • Abrufen einer Liste aller verfügbaren Dokumente (für die Autovervollständigung)
  • Abrufen des Inhalts eines bestimmten Dokuments (wenn es erwähnt wird)

Ein in einen Chat-Prompt eingegebenes „@“ öffnet eine Liste von Dokumenten, wie deposition.md und spec.md, jeweils mit der Kennzeichnung „Resource“.

Wenn ein Nutzer @ eingibt, musst du die verfügbaren Dokumente anzeigen. Wenn er eine Nachricht mit einer Erwähnung absendet, fügst du den Inhalt dieses Dokuments automatisch in den Prompt ein, der an Claude gesendet wird.

Die Eingabe eines At-Zeichens listet Dokumente wie design.md auf, jeweils mit der Kennzeichnung „Resource“, und eine Erwähnung fügt den Inhalt von report.pdf ein.

Wie Ressourcen funktionieren

Ressourcen folgen einem Request-Response-Muster. Dein Client sendet eine ReadResourceRequest mit einer URI, und der MCP-Server antwortet mit den Daten. Die URI fungiert wie eine Adresse für die Ressource, auf die du zugreifen möchtest.

Diagramm eines MCP-Servers mit zwei Ressourcendefinitionen, list_docs und fetch_doc, die im Code unten gezeigt werden.

Arten von Ressourcen

Es gibt zwei Arten von Ressourcen:

Decorator-Code für eine direkte Ressource ohne Parameter in ihrer URI und eine Template-Ressource mit doc_id, wie unten beschrieben.

  • Direkte Ressourcen: Statische URIs, die sich nicht ändern, wie docs://documents
  • Template-Ressourcen: URIs mit Parametern, wie docs://documents/{doc_id}

Bei Template-Ressourcen analysiert das Python SDK automatisch die Parameter aus der URI und übergibt sie als Keyword-Argumente an deine Funktion.

Ressourcen implementieren

Ressourcen werden mit dem Decorator @mcp.resource() definiert. So erstellst du beide Typen:

Direkte Ressource (Dokumente auflisten)

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

Template-Ressource (Dokument abrufen)

python
@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]

MIME-Typen

Ressourcen können jede Art von Daten zurückgeben – Strings, JSON, Binärdaten usw. Der Parameter mime_type gibt Clients einen Hinweis darauf, welche Art von Daten du zurückgibst:

  • application/json - Strukturierte JSON-Daten
  • text/plain - Reiner Textinhalt
  • Jeder andere gültige MIME-Typ für unterschiedliche Datenformate

Das MCP Python SDK serialisiert deine Rückgabewerte automatisch. Du musst sie nicht manuell in JSON-Strings umwandeln.

Ressourcen testen

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

bash
uv run mcp dev mcp_server.py

Verbinde dich dann in deinem Browser mit dem Inspector. Du wirst Folgendes sehen:

MCP Inspector-Tab „Resources“, mit docs://documents unter „Resources“ gelistet und nichts unter „Resource Templates“ gelistet.

  • Resources: Listet deine direkten/statischen Ressourcen auf
  • Resource Templates: Zeigt Template-Ressourcen, die Parameter akzeptieren

Klicke auf eine beliebige Ressource, um sie zu testen und die genaue Antwortstruktur zu sehen, die dein Client erhalten wird.

MCP Inspector-Tab „Resources“: Das Lesen von docs://documents liefert eine JSON-Liste von Dateinamen wie deposition.md und plan.md.

Kernpunkte

  • Ressourcen stellen Daten bereit, Tools führen Aktionen aus
  • Verwende direkte Ressourcen für statische Daten, Template-Ressourcen für parametrisierte Abfragen
  • MIME-Typen helfen Clients, das Antwortformat zu verstehen
  • Das SDK übernimmt die Serialisierung automatisch
  • Parameternamen in Template-URIs werden zu Funktionsargumenten

Ressourcen bieten eine saubere Möglichkeit, Daten für MCP-Clients verfügbar zu machen, und ermöglichen Funktionen wie Dokumenterwähnungen, Dateisuche oder jedes andere Szenario, in dem du Informationen von deinem Server abrufen musst.