LLMs mit MCP mit Cloud Storage verbinden

In diesem Leitfaden erfahren Sie, wie Sie Cloud Storage mit integrierten Entwicklungsumgebungen (IDEs) und Entwicklertools verbinden. Dazu führen Sie einen lokalen MCP-Server auf Ihrem Computer aus, indem Sie die MCP Toolbox for Databases verwenden.

Die MCP-Toolbox für Datenbanken ist ein Open-Source-Repository, das Connectors für Datenbanken und Datenspeicher wie Cloud Storage, BigQuery, AlloyDB, Spanner und Cloud SQL enthält. Die Toolbox unterstützt die OAuth2- und OIDC-Authentifizierung und lässt sich für die Observability in OpenTelemetry einbinden. Durch die Einbindung der Cloud Storage-Toolbox können Sie ein LLM verwenden, um die folgenden Aktionen auszuführen:

  • Buckets erstellen, auflisten und löschen
  • Bucket- und Objektmetadaten abrufen
  • IAM-Richtlinien (Identity and Access Management) für Ihre Buckets abrufen.
  • Objekte lesen, schreiben, hochladen und herunterladen.
  • Objekte kopieren oder verschieben

In dieser Anleitung wird der Verbindungsprozess für die folgenden IDEs und Tools beschrieben:

  • Cursor
  • Windsurf (ehemals Codeium)
  • Visual Studio Code (Copilot)
  • Cline (VS Code-Erweiterung)
  • Claude für den Computer
  • Claude-Code
  • Antigravity

Hinweis

  1. Wählen Sie in der Cloud de Confiance Console auf der Seite für die Projektauswahl ein Cloud de Confiance by S3NS Projekt aus oder erstellen Sie eines.

  2. Achten Sie darauf, dass die Abrechnung für Ihr Projekt in Cloud de Confiance aktiviert ist.

  3. Aktivieren Sie die Cloud Storage API im Cloud de Confiance -Projekt.

  4. Konfigurieren Sie die erforderlichen Rollen und Berechtigungen, um diese Aufgabe auszuführen. Der Nutzer, der die LLM-Agents aufruft, benötigt die folgenden Rollen auf Bucket- oder Projektebene:

    • Zum Auflisten, Erstellen und Löschen leerer Buckets: Storage-Administrator (roles/storage.admin)
    • Zum Auflisten von Objekten, Lesen von Objekten, Abrufen von Objektmetadaten oder Bucket-Metadaten: Storage-Objektbetrachter (roles/storage.objectViewer)
    • Zum Schreiben von Inhalten in ein Objekt oder zum Hochladen eines Objekts: Storage-Objekt-Ersteller (roles/storage.objectCreator)
    • Zum Kopieren, Verschieben oder Löschen von Objekten: Storage-Objekt-Administrator (roles/storage.objectAdmin)

  5. Konfigurieren Sie Standardanmeldedaten für Anwendungen (ADC) für Ihre Umgebung.

Mit Antigravity verbinden

Sie verbinden Cloud Storage mit Antigravity über eine benutzerdefinierte Konfiguration. In diesem Zusammenhang ist ein benutzerdefinierter MCP-Server ein Server, den Sie manuell konfigurieren, indem Sie Ihre Konfigurationsdatei (z. B. mcp_config.json) bearbeiten. Diese manuelle Konfiguration wird verwendet, anstatt den Server direkt aus dem integrierten MCP Store-Katalog zu installieren.

So konfigurieren Sie einen benutzerdefinierten MCP-Server:

  1. Prüfen Sie, ob npx auf Ihrem System installiert und richtig konfiguriert ist. Führen Sie dazu npx --version im Terminal aus. Wenn Sie Node.js installieren müssen, das npx enthält, lesen Sie die npm-Anleitung Node.js und npm herunterladen und installieren.
  2. Öffnen Sie Antigravity und rufen Sie den MCP-Store über das Drop-down-Menü „…“ oben im Agent-Bereich des Editors auf.
  3. Klicken Sie auf MCP-Server und dann auf MCP-Server verwalten > Rohkonfiguration ansehen, um die Datei mcp_config.json zu öffnen.
  4. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie den Platzhalter durch Ihre Projekt-ID und speichern Sie die Datei: 
    {
  "mcpServers": {
    "storage": {
      "command": "npx",
      "args": ["-y","@toolbox-sdk/server","--prebuilt","cloud-storage","--stdio"],
      "env": {
          "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
      }
    }
  }
}

MCP-Toolbox installieren

Die Toolbox ist ein Open-Source-MCP-Server (Model Context Protocol), der lokal auf Ihrem Computer ausgeführt wird. Der lokale Server verwaltet die Kommunikation zwischen Ihrer IDE und Cloud Storage. Diese Verbindung bietet eine sichere und effiziente Umgebung für Ihre KI-Tools.

  1. Laden Sie die aktuelle Version der MCP Toolbox als Binärprogramm herunter. Wählen Sie das Binärprogramm aus, das Ihrem Betriebssystem und Ihrer CPU-Architektur entspricht. Sie müssen die MCP Toolbox-Version 1.2.0 oder höher verwenden:

    linux/amd64

    curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/linux/amd64/toolbox

    Ersetzen Sie VERSION durch die Version der MCP Toolbox, z. B. v1.2.0.

    macOS darwin/arm64

    curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/arm64/toolbox

    Ersetzen Sie VERSION durch die Version der MCP Toolbox, z. B. v1.2.0.

    macOS darwin/amd64

    curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/amd64/toolbox

    Ersetzen Sie VERSION durch die Version der MCP Toolbox, z. B. v1.2.0.

    windows/amd64

    curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/windows/amd64/toolbox

    Ersetzen Sie VERSION durch die Version der MCP Toolbox, z. B. v1.2.0.

  2. So machen Sie die Binärdatei ausführbar:

    chmod +x toolbox

  3. Installation prüfen:

    ./toolbox --version

Informationen zum Einrichten der Toolbox mit einem Container-Image oder Homebrew finden Sie auf der Seite Toolbox installieren.

Clients und Verbindungen einrichten

In diesem Abschnitt wird beschrieben, wie Sie Cloud Storage mit Ihren Tools verbinden, nachdem Sie die MCP Toolbox installiert haben.

Claude-Code

  1. Installieren Sie Claude Code.
  2. Erstellen Sie im Stammverzeichnis Ihres Projekts eine .mcp.json-Datei, falls sie noch nicht vorhanden ist.
  3. Fügen Sie die Konfiguration hinzu, ersetzen Sie die Platzhalter durch Ihre Werte und speichern Sie die Datei: 
            {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
    Ersetzen Sie die folgenden Variablen durch Ihre Werte:
    • ./PATH/TO/toolbox: Der Pfad zu Ihrem toolbox-Binärprogramm.
    • CLOUD_STORAGE_PROJECT: Die Umgebungsvariable, die die Cloud de Confiance Projekt-ID angibt.
    • PROJECT_ID: Ihre Cloud de Confiance by S3NS Projekt-ID
  4. Starten Sie Claude Code neu, um die neuen Einstellungen zu laden. Wenn Claude Code wieder geöffnet wird, erkennt die Anwendung den konfigurierten MCP-Server.

Claude für den Computer

  1. Öffnen Sie Claude für Desktop und rufen Sie die Einstellungen auf.
  2. Klicken Sie auf dem Tab Entwickler auf Konfiguration bearbeiten, um die Konfigurationsdatei zu öffnen.
  3. Fügen Sie die Konfiguration hinzu, ersetzen Sie die Platzhalter durch Ihre Werte und speichern Sie die Datei: 
            {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
    Ersetzen Sie die folgenden Variablen durch Ihre Werte:
    • ./PATH/TO/toolbox: Der Pfad zu Ihrem toolbox-Binärprogramm.
    • CLOUD_STORAGE_PROJECT: Die Umgebungsvariable, die die Cloud de Confiance Projekt-ID angibt.
    • PROJECT_ID: Ihre Cloud de Confiance by S3NS Projekt-ID
  4. Starten Sie Claude für den Computer neu.
  5. Auf dem neuen Chatbildschirm wird ein Hammersymbol (MCP) mit dem neuen MCP-Server angezeigt.

Cline

  1. Öffnen Sie die Cline-Erweiterung in VS Code und klicken Sie auf das Symbol MCP-Server.
  2. Klicken Sie auf MCP-Server konfigurieren, um die Konfigurationsdatei zu öffnen.
  3. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie die Platzhalter durch Ihre Werte und speichern Sie die Datei: 
            {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
    Ersetzen Sie die folgenden Variablen durch Ihre Werte:
    • ./PATH/TO/toolbox: Der Pfad zu Ihrem toolbox-Binärprogramm.
    • CLOUD_STORAGE_PROJECT: Die Umgebungsvariable, die die Cloud de Confiance Projekt-ID angibt.
    • PROJECT_ID: Ihre Cloud de Confiance by S3NS Projekt-ID

Nach erfolgreicher Verbindung des Servers wird ein grüner aktiver Status angezeigt.

Cursor

  1. Erstellen Sie das Verzeichnis .cursor im Stammverzeichnis Ihres Projekts, falls es noch nicht vorhanden ist.
  2. Erstellen Sie die Datei .cursor/mcp.json, falls sie noch nicht vorhanden ist, und öffnen Sie sie.
  3. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie die Platzhalter durch Ihre Werte und speichern Sie die Datei: 
            {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
    Ersetzen Sie die folgenden Variablen durch Ihre Werte:
    • ./PATH/TO/toolbox: Der Pfad zu Ihrem toolbox-Binärprogramm.
    • CLOUD_STORAGE_PROJECT: Die Umgebungsvariable, die die Cloud de Confiance Projekt-ID angibt.
    • PROJECT_ID: Ihre Cloud de Confiance by S3NS Projekt-ID
  4. Öffnen Sie Cursor und gehen Sie zu Einstellungen > Cursoreinstellungen > MCP. Wenn der Server verbunden ist, wird ein grüner aktiver Status angezeigt.

Visual Studio Code (Copilot)

  1. Öffnen Sie VS Code und erstellen Sie im Stammverzeichnis Ihres Projekts das Verzeichnis .vscode, falls es noch nicht vorhanden ist.
  2. Erstellen Sie die Datei .vscode/mcp.json, falls sie noch nicht vorhanden ist, und öffnen Sie sie.
  3. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie die Platzhalter durch Ihre Werte und speichern Sie die Datei: 
            {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
    Ersetzen Sie die folgenden Variablen durch Ihre Werte:
    • ./PATH/TO/toolbox: Der Pfad zu Ihrem toolbox-Binärprogramm.
    • CLOUD_STORAGE_PROJECT: Die Umgebungsvariable, die die Cloud de Confiance Projekt-ID angibt.
    • PROJECT_ID: Ihre Cloud de Confiance by S3NS Projekt-ID
  4. Aktualisieren Sie das VS Code-Fenster. Die MCP-kompatible Erweiterung erkennt die Konfiguration automatisch und startet den Server.

Windsurf

  1. Öffnen Sie Windsurf und rufen Sie den Cascade-Assistenten auf.
  2. Klicken Sie auf das MCP-Symbol und dann auf Konfigurieren, um die Konfigurationsdatei zu öffnen.
  3. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie die Platzhalter durch Ihre Werte und speichern Sie die Datei: 
            {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
    Ersetzen Sie die folgenden Variablen durch Ihre Werte:
    • ./PATH/TO/toolbox: Der Pfad zu Ihrem toolbox-Binärprogramm.
    • CLOUD_STORAGE_PROJECT: Die Umgebungsvariable, die die Cloud de Confiance Projekt-ID angibt.
    • PROJECT_ID: Ihre Cloud de Confiance by S3NS Projekt-ID

Vordefinierte Tools

Nachdem Sie die MCP-Toolbox mit Cloud Storage verbunden haben, verwendet Ihr Agent die folgenden integrierten Tools:

  • list_buckets: Listet Cloud Storage-Buckets im konfigurierten Projekt auf.
  • list_objects: Listet Objekte in einem Bucket mit optionaler Präfix- und Trennzeichenfilterung auf.
  • get_bucket_metadata: Gibt Metadaten für einen Bucket zurück.
  • get_bucket_iam_policy: Gibt die IAM-Richtlinienbindungen für einen Bucket zurück.
  • get_object_metadata: Gibt Metadaten für ein Objekt zurück.
  • read_object: Liest ein UTF‑8-Textobjekt (oder einen Bytebereich). Die maximale Größe beträgt 8 MiB. Binärobjekte werden abgelehnt.
  • download_object: Lädt ein Objekt in einen lokalen Pfad herunter.
  • create_bucket: Erstellt einen Bucket im konfigurierten Projekt.
  • delete_bucket: Löscht einen leeren Bucket.
  • upload_object: Lädt eine lokale Datei in ein Objekt hoch.
  • write_object: Schreibt Textinhalte direkt in ein Objekt.
  • copy_object: Kopiert ein Objekt in ein Zielobjekt.
  • move_object: Benennt ein Objekt innerhalb desselben Buckets atomar um.
  • delete_object: Löscht ein Objekt.