Gemini Cloud Assist MCP Server

Gemini Cloud Assist MCP-Server

[!IMPORTANT] Private Preview-Hinweis Die Gemini Cloud Assist MCP-Server-APIs befinden sich derzeit in der Private Preview und sind durch eine Zulassungsliste geschützt. Bitte wenden Sie sich an Ihr Google Cloud-Kontoteam, um Zugriff zu beantragen.

[!WARNING] Einstellungshinweis & 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 nicht mehr unterstützt.

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

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

[!NOTE] Die Google Cloud Platform-Nutzungsbedingungen (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-Server-Software.

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

✨ Hauptfunktionen

• Infrastruktur entwerfen: Erstellen und 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 Effizienzmöglichkeiten 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 Sie Folgendes eingerichtet haben:

• Google Cloud SDK installiert und konfiguriert.
• Ein Google Cloud-Projekt.
• Die folgenden IAM-Rollen für Ihr Benutzerkonto:
  • roles/serviceusage.serviceUsageAdmin: Erforderlich, um die Cloud Assist-APIs zu aktivieren.
  • roles/geminicloudassist.user: Erforderlich, um Anfragen an die Cloud Assist-APIs zu stellen.

Schritt 1: Bei Google Cloud authentifizieren

Der Gemini Cloud Assist MCP-Server verwendet lokale Standardanmeldedaten der Anwendung (Application Default Credentials, ADC), um sich sicher bei Google Cloud zu authentifizieren. Führen Sie zur Einrichtung 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

Konfigurieren Sie Ihren MCP-Client

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

Gemini CLI

Installieren Sie den MCP-Server als Gemini CLI-Erweiterung:

gemini extensions install https://github.com/GoogleCloudPlatform/gemini-cloud-assist-mcp

Alternativ können Sie die Konfiguration manuell zu Ihrer ~/.gemini/settings.json hinzufügen:

"mcpServers": {
  "gemini_cloud_assist": {
    "httpUrl": "https://geminicloudassist.googleapis.com/mcp",
    "authProviderType": "google_credentials",
    "oauth": {
      "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
    },
    "timeout": 600000
  },
  "application_design_center": {
    "httpUrl": "https://designcenter.googleapis.com/mcp",
    "authProviderType": "google_credentials",
    "oauth": {
      "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
    },
    "timeout": 600000
  }
}

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 spezifische Anwendung:

• Claude.ai

MCP-Tools

Gemini Cloud Assist MCP-Tools

Gemini Cloud Assist ist ein Agent, auf den über eine Reihe von MCP-Tools zugegriffen werden kann. Der durch MCP-Toolaufrufe aufgerufene Agent führt intern eigene Toolaufrufe an Google Cloud durch. 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 Gestalten von Infrastruktur in Google Cloud.
investigate_issue	Unterstützt Workflows zur Fehlerbehebung in Google Cloud. Kann schnelle Fehlerbehebung oder tiefere Fehlerbehebung über eine Untersuchungsressource durchführen.
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 oft vom design_infra-Tool von GCA orchestriert werden, verwalten den Lebenszyklus von Infrastrukturanwendungen mit dem Application Design Center, einschließlich Vorlagenverwaltung, Sicherheitskonformität und -behebung 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 mit dem 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 in Google Cloud umwandelt.
manage_application_template	Verwaltet den Infrastructure as Code (IaC)-Inhalt 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 vor der Bereitstellung eine umfassende Sicherheits- und Konfigurationsprüfung Ihres Anwendungsdesigns durch. Es validiert das Design anhand von Security Command Center-Frameworks und relevanten Kontrollen 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 weiterentwickelnden Fähigkeiten von Gemini Cloud Assist Rechnung zu tragen.

Agentenfähigkeiten

Die Gemini Cloud Assist MCP-Tools nutzen SKILL.md-Dateien, um Ihren Agenten anzuweisen, wie die Tools richtig zu verwenden sind. Die Fähigkeiten helfen, Ihren Agenten dabei zu leiten, mehrere Tools zu einem Arbeitsablauf zu verketten, relevante lokale Informationen an Gemini Cloud Assist weiterzugeben und den expliziten Aufruf zu ermöglichen.

Fähigkeit	Beschreibung
designing-and-deploying-infrastructure	Leitet den Agenten an, wie Cloud-Infrastruktur mit den Application Design Center (ADC)- und Gemini Cloud Assist-Tools entworfen, bewertet, bereitgestellt und Fehler behoben werden.
operating-google-cloud	Bietet Anweisungen zur Verwaltung von Google Cloud Platform (GCP)-Ressourcen und Kubernetes mit spezialisierten MCP-Tools.

Mitwirken

• Wenn Sie auf einen Fehler stoßen, melden Sie bitte ein Problem 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 Mängelgewähr und ohne jegliche Zusicherung für irgendeine Nutzung oder einen bestimmten Zweck bereitgestellt. Einzelheiten finden Sie in der LICENSE-Datei.