Gemini Cloud Assist

Gemini Cloud Assist MCP-Server

[!IMPORTANT] Hinweis zur Private Preview Die APIs des Gemini Cloud Assist MCP-Servers befinden sich derzeit in der Private Preview und sind durch eine Zulassungsliste geschützt. Bitte kontaktieren Sie Ihr Google-Cloud-Kontoteam, um Zugriff anzufragen.

[!WARNING] Hinweis zur Einstellung & Migration zum Remote-MCP-Server

Der Gemini Cloud Assist MCP-Server wurde von einer lokalen Node.js-Architektur auf eine Remote-MCP-Server-Architektur migriert. Der ältere lokale Node.js-Server wird in den kommenden Monaten keinen Support mehr erhalten.

Um die neuen Remote-MCP-Server zu verwenden, nutzen Sie bitte Version v0.8.0 oder höher. Wenn Sie den Legacy-Server während der Übergangsphase weiterhin verwenden möchten, fixieren Sie Ihre Konfiguration bitte auf ältere Versionen.

Dieser Server verbindet Model Context Protocol (MCP)-Clients mit den Gemini Cloud Assist APIs. Er ermöglicht es Ihnen, Ihre Google-Cloud-Umgebung direkt über die lokale Befehlszeile in natürlicher Sprache zu verstehen, zu verwalten und Fehler zu beheben.

[!NOTE] Die Nutzungsbedingungen der Google Cloud Platform (verfügbar unter https://cloud.google.com/terms/) und die Datenverarbeitungs- und Sicherheitsbedingungen (verfügbar unter https://cloud.google.com/terms/data-processing-terms) gelten nicht für Komponenten der Gemini Cloud Assist MCP-Serversoftware.

Weitere Informationen zu Gemini Cloud Assist finden Sie in der Übersicht zu Gemini Cloud Assist in der Google-Cloud-Dokumentation.

✨ Hauptfunktionen

• Infrastruktur entwerfen: Erstellen und architektonisch gestalten Sie Infrastrukturkonfigurationen für Google Cloud.
• Probleme beheben: Führen Sie tiefgehende Untersuchungen durch, um die Ursache komplexer Probleme in Ihrer Google-Cloud-Umgebung zu finden.
• Ressourcen verwalten: Erstellen, aktualisieren und löschen Sie Google-Cloud-Ressourcen direkt aus Ihrem Chat-Workflow (erfordert Agent Actions).
• Kosten optimieren: Analysieren Sie Ihre Ausgaben, verfolgen Sie Kosten und identifizieren Sie Effizienzpotenziale wie ungenutzte Ressourcen.
• Allgemeine Unterstützung erhalten: Stellen Sie Fragen und erhalten Sie Anleitungen zu Best Practices, Architekturen und Betrieb von Google Cloud.

Schnellstart

Bevor Sie beginnen, stellen Sie sicher, dass Folgendes eingerichtet ist:

• Google Cloud SDK installiert und konfiguriert.
• Ein Google-Cloud-Projekt.
• Die folgenden IAM-Rollen für Ihr Benutzerkonto:
  • roles/serviceusage.serviceUsageAdmin: Erforderlich zum Aktivieren der Cloud-Assist-APIs.
  • roles/geminicloudassist.user: Erforderlich zum Senden von Anfragen an die Cloud-Assist-APIs.

Schritt 1: Bei Google Cloud authentifizieren

Der Gemini Cloud Assist MCP-Server verwendet lokale Application Default Credentials (ADC), um sich sicher bei Google Cloud zu authentifizieren. Führen Sie zum Einrichten von ADC die folgenden gcloud-Befehle aus:

# Authenticate your user account to the gcloud CLI
gcloud auth login

# Set up Application Default Credentials for the server.
gcloud auth application-default login

MCP-Client konfigurieren

Die Client-Agent-Konfiguration hängt davon ab, welchen Agenten Sie verwenden.

Antigravity

Fügen Sie Folgendes zu Ihrer mcp_config.json hinzu:

"mcpServers": {
  "gemini_cloud_assist": {
    "serverUrl": "https://geminicloudassist.googleapis.com/mcp",
    "headers": {},
    "authProviderType": "google_credentials"
  },
  "application_design_center": {
    "serverUrl": "https://designcenter.googleapis.com/mcp",
    "headers": {},
    "authProviderType": "google_credentials"
  }
}

Cursor

1. Erstellen Sie in Ihrem Google-Cloud-Projekt eine OAuth-2.0-Client-ID für eine Desktop-App.
2. Konfigurieren Sie URI://anysphere.cursor-mcp/oauth/callback als Weiterleitungs-URL.
3. Fügen Sie den folgenden Konfigurationsblock hinzu oder führen Sie ihn zusammen:

{
  "mcpServers": {
    "gemini_cloud_assist": {
      "url": "https://geminicloudassist.googleapis.com/mcp",
      "auth": {
        "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      }
    },
    "application_design_center": {
      "url": "https://designcenter.googleapis.com/mcp",
      "auth": {
        "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      }
    }
  }
}

Claude

Befolgen Sie die Konfigurationsanweisungen für Ihre jeweilige Anwendung:

• Claude.ai

MCP-Tools

Gemini Cloud Assist MCP-Tools

Gemini Cloud Assist ist ein Agent, der über eine Reihe von MCP-Tools zugänglich ist. Der durch MCP-Toolaufrufe aufgerufene Agent führt intern eigene Toolaufrufe an Google Cloud aus. Die folgenden MCP-Tools werden für Agenten zur Nutzung veröffentlicht:

Tool	Beschreibung
ask_cloud_assist	Die primäre Schnittstelle für Google-Cloud-Unterstützung und für den Gemini Cloud Assist-Agenten. Alle Funktionen sind über dieses Tool zugänglich.
design_infra	Unterstützt Workflows zum Entwerfen und Architektonischen Gestalten von Infrastruktur auf Google Cloud.
investigate_issue	Unterstützt Workflows zur Fehlerbehebung in Google Cloud. Bietet schnelle Fehlerbehebung oder tiefergehende Fehlerbehebung über eine Untersuchungsressource.
invoke_operation	Unterstützt Workflows zum Erstellen, Aktualisieren und Löschen von Ressourcen in Google Cloud. Nur funktionsfähig, wenn Agent Actions aktiviert sind.
optimize_costs	Unterstützt Workflows zum Analysieren, Verfolgen und Optimieren von Google-Cloud-Kosten. Bietet Aufschlüsselungen der Ausgaben und identifiziert Möglichkeiten zur Kosteneffizienz.

Application Design Center MCP-Tools

Application Design Center MCP-Tools, die häufig vom design_infra-Tool von GCA orchestriert werden, verwalten den Lebenszyklus von Infrastrukturanwendungen mithilfe des Application Design Center, einschließlich Vorlagenverwaltung, Sicherheitskonformität und -sanierung sowie Bereitstellung.

Tool	Beschreibung
setup_adc	Initialisiert die Application Design Center-Umgebung. Dies ist ein einmaliger Einrichtungsschritt, der ausgeführt werden muss, bevor andere ADC-Tools verwendet werden können.
manage_application	Verwaltet den Bereitstellungslebenszyklus einer Anwendung. Verwenden Sie dieses Tool, um ein verifiziertes Design mithilfe des Application Design Center bereitzustellen oder den Status und die Details einer vorhandenen Bereitstellung abzurufen. Dies ist der letzte Schritt, der Ihr Design in eine bereitgestellte Infrastruktur auf Google Cloud verwandelt.
manage_application_template	Verwaltet den Infrastructure-as-Code-Inhalt (IaC) Ihres Infrastrukturdesigns. Verwenden Sie dies, um das Design als Application Design Center-Vorlage zu speichern, das Design als Terraform-Dateien zu exportieren oder das Design zu aktualisieren (z. B. Komponenten, Parameterkonfigurationen usw.).
assess_best_practices	Führt eine umfassende Sicherheits- und Konfigurationsprüfung Ihres Anwendungsdesigns vor der Bereitstellung durch. Es validiert das Design anhand der Frameworks und relevanten Kontrollen des Security Command Center und gibt einen Bericht mit umsetzbaren Ergebnissen zur Behebung zurück.
list_application_templates	Listet alle verfügbaren Anwendungsdesigns auf.

Hinweis: Diese Tools sollten nicht als stabile APIs behandelt werden. Parameter können umbenannt oder geändert werden, um den sich entwickelnden Funktionen von Gemini Cloud Assist Rechnung zu tragen.

Agent-Fähigkeiten

Die Gemini Cloud Assist MCP-Tools nutzen SKILL.md-Dateien, um Ihren Agenten anzuweisen, wie die Tools ordnungsgemäß verwendet werden. Die Fähigkeiten helfen dabei, Ihren Agenten beim Verketten mehrerer Tools zu einem Workstream zu leiten, relevante lokale Informationen an Gemini Cloud Assist weiterzugeben und explizite Aufrufe zu ermöglichen.

Fähigkeit	Beschreibung
designing-and-deploying-infrastructure	Führt den Agenten durch das Entwerfen, Bewerten, Bereitstellen und Beheben von Cloud-Infrastruktur mithilfe des Application Design Center (ADC) und der Gemini Cloud Assist-Tools.
operating-google-cloud	Bietet Anweisungen zum Verwalten von Google-Cloud-Platform-Ressourcen (GCP) und Kubernetes mithilfe spezialisierter MCP-Tools.

Mitwirken

• Wenn Sie einen Fehler entdecken, melden Sie bitte ein Issue auf unserer GitHub Issues-Seite.
• Bevor Sie einen Pull-Request senden, lesen Sie bitte unseren Leitfaden zum Mitwirken.

Lizenz

Dieses Projekt ist unter der Apache-2.0-Lizenz lizenziert und wird ohne Gewährleistung oder Zusicherung für jegliche Nutzung oder Zweck bereitgestellt. Details finden Sie in der LICENSE-Datei.