wasabi-mcp

MCP-Server für Wasabi (S3-kompatibler Hot Cloud Storage). Stellt die Bucket-Nutzungsdaten der Wasabi Stats API als MCP-Tool bereit.

Überblick

• Zustandsloser HTTP-Dienst. Es werden niemals Anmeldedaten gespeichert – jede Anfrage übermittelt ihre eigenen Anmeldedaten über Header, die nur für die Lebensdauer dieser einzelnen Anfrage verwendet werden.

• Unterstützt gleichzeitige Anfragen; die Isolierung der Anmeldedaten pro Anfrage erfolgt über Python-contextvars, nicht über eine globale/geteilte Client-Instanz.

• Einstiegspunkte: POST /mcp (MCP-Protokoll) und GET /health (Gesundheitscheck).

• Standardport: 8080 (konfigurierbar über MCP_HTTP_PORT).

Related MCP server: mcp-server-s3

Authentifizierung

Die Wasabi Stats API (stats.wasabisys.com) – eine separate, einfachere API im Vergleich zur S3-kompatiblen Objektspeicher-API – verwendet einen einzigen statischen Header, ohne Login-/Token-Austausch:

Authorization: <AccessKey>:<SecretKey>

Die verwendeten Schlüssel müssen Wasabi-Root-Schlüssel oder Unterbenutzerschlüssel mit einer zugehörigen Abrechnungs-/Statistikrichtlinie (WasabiAccountStatsAccess oder WasabiBucketStatsAccess) sein – reine Speicher-Schlüssel werden abgelehnt. Dies ist bereits vom Hersteller selbst vollständig zustandslos; nichts wird über MCP-Aufrufe hinweg zwischengespeichert.

Header-Autorisierungsparameter

Fehlt einer der beiden Header, wird 401 zurückgegeben:

{
  "error": "Missing credentials",
  "message": "This server requires the X-Wasabi-Access-Key and X-Wasabi-Secret-Key headers",
  "required_headers": ["X-Wasabi-Access-Key", "X-Wasabi-Secret-Key"],
  "optional_headers": []
}

Umgebungsvariablen

MCP-Endpunkt

• POST /mcp – MCP-Protokoll (streambarer HTTP-Transport)

• GET /health – Gesundheitscheck, gibt {"status": "ok"} zurück (reine lokale Prüfung, ruft die Wasabi-API nicht auf)

Werkzeugliste

Antworten sind das rohe JSON des Anbieters ({"PageInfo": {...}, "Records": [...]}), kompakt serialisiert (ohne Einrückung, ensure_ascii=False) und auf 20.000 Zeichen begrenzt – wenn die Records-Liste die Antwort darüber hinaus treiben würde, wird sie mit truncated/truncated_field/original_count-Markierungen im Payload abgeschnitten.

Fehlerbehandlung

Bei Fehlern geben Werkzeuge einen JSON-Fehlerumschlag (als Zeichenfolge, nicht als Protokollfehler) zurück, anstatt eine Ausnahme auszulösen:

{"error": {"code": "upstream_error", "message": "...", "retryable": true}}

code ist eine von einer festen Vokabelliste: not_configured, unauthorized, not_found, invalid_argument, rate_limited, upstream_error. retryable teilt dem Aufrufer mit, ob ein erneuter Versuch sinnvoll ist. Leere Ergebnismengen (keine Nutzungsdatensätze für den angeforderten Zeitraum) werden als normales leeres Ergebnis zurückgegeben, nicht als Fehler.

Testbeispiel

# Health check
curl -s http://localhost:8080/health

# Call a tool via the MCP protocol (streamable HTTP) — requires an
# initialize handshake first per the MCP spec; abbreviated example below
# shows the tool-call request body only:
curl -s -X POST http://localhost:8080/mcp \
  -H "X-Wasabi-Access-Key: <your-access-key>" \
  -H "X-Wasabi-Secret-Key: <your-secret-key>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: <session-id-from-initialize>" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "wasabi_get_bucket_utilizations",
      "arguments": {}
    }
  }'

Live-verifiziert (2026-07-30) gegen ein echtes Wasabi-Konto: wasabi_get_bucket_utilizations Ende-zu-Ende über diesen laufenden Server aufgerufen lieferte echte Daten – 540 echte Bucket-Nutzungsdatensätze über 270 Seiten, einschließlich echter Bucket-Namen (z. B. "oraclegroup", "centrewestib") in der Region ap-southeast-2, mit echten Speicher-/API-Aufruf-Metriken.

API-Referenz

• Öffentlich, keine Anmeldung erforderlich:

  • Übersicht: https://docs.wasabi.com/apidocs/wasabi-stats-api

  • Authentifizierung: https://docs.wasabi.com/apidocs/authentication-with-wasabi-stats-api

  • Dieser Endpunkt: https://docs.wasabi.com/apidocs/stats-api-get-v1standalone-bucket-utilizations

Bekannte Lücken

• Der Umfang ist genau der eine konfigurierte Endpunkt von MSPbots, nicht die vollständige API-Oberfläche des Anbieters – die Wasabi-Stats-API bietet auch einen Kontoübersichts-Endpunkt (GET /v1/standalone/utilizations) und detaillierte Bucket-Abfragen nach Name oder Nummer; diese sind hier nicht enthalten. Die S3-kompatible Objektspeicher-API von Wasabi (Bucket-/Objekt-CRUD) ist eine völlig separate API und ebenfalls nicht enthalten.

• Das Feld region, das MSPbots für diese Integration ebenfalls speichert, wird von diesem Server nicht verwendet – der eine Endpunkt, den MSPbots tatsächlich nutzt (Stats-API-Bucket-Nutzungen), hat eine feste Basis-URL (https://stats.wasabisys.com), unabhängig davon, in welcher Wasabi-Region ein bestimmter Bucket liegt; jeder zurückgegebene Datensatz enthält bereits sein eigenes Region-Feld. region wäre nur für direkte S3-kompatible Objektspeicheraufrufe relevant, die dieser Server nicht durchführt.

• Die Standardwerte für den from/to-Datumsbereich werden vom Anbieter gesteuert – wenn sie weggelassen werden, verwendet Wasabi standardmäßig "vor einem Monat" bis "heute"; dieser Server wendet keinen eigenen Standard an und lässt den Parameter einfach weg, wenn er nicht angegeben wird.