GCP MCP

GCP MCP

Ein Model Context Protocol (MCP)-Server, der KI-Assistenten wie Claude die Interaktion mit Ihrer Google Cloud Platform-Umgebung ermöglicht. Dies ermöglicht Abfragen in natürlicher Sprache und die Verwaltung Ihrer GCP-Ressourcen während Konversationen.

Merkmale

• 🔍 GCP-Ressourcen mithilfe natürlicher Sprache abfragen und ändern
• ☁️ Unterstützung für mehrere GCP-Projekte
• 🌐 Unterstützung mehrerer Regionen
• 🔐 Sichere Handhabung der Anmeldeinformationen (es werden keine Anmeldeinformationen an externe Dienste weitergegeben)
• 🏃‍♂️ Lokale Ausführung mit Ihren GCP-Anmeldeinformationen
• 🔄 Automatische Wiederholungsversuche für verbesserte Zuverlässigkeit

Voraussetzungen

• Node.js
• Claude Desktop/Cursor/Windsurf
• GCP-Anmeldeinformationen lokal konfiguriert (Standardanmeldeinformationen der Anwendung)

Installation

1. Klonen Sie das Repository:

2. Installieren Sie Abhängigkeiten:

Konfiguration

Claude Desktop

1. Öffnen Sie die Claude-Desktop-App und gehen Sie zu Einstellungen -> Entwickler -> Konfiguration bearbeiten
2. Fügen Sie den folgenden Eintrag zu Ihrer claude_desktop_config.json hinzu:

über npm:

Wenn Sie die Installation aus der Quelle durchgeführt haben:

Ersetzen Sie /path/to/gcp-mcp durch den tatsächlichen Pfad zu Ihrem Projektverzeichnis, wenn Sie die Quellinstallation verwenden.

Cursor

1. Öffnen Sie Cursor und gehen Sie zu Einstellungen (⌘,)
2. Navigieren Sie zu AI -> Model Context Protocol
3. Fügen Sie eine neue MCP-Konfiguration hinzu:

Windsurf

1. Öffnen Sie ~/.windsurf/config.json (erstellen Sie es, falls es nicht existiert)
2. Fügen Sie die MCP-Konfiguration hinzu:

GCP-Einrichtung

1. Richten Sie die GCP-Anmeldeinformationen ein:
   • Richten Sie die Standardanmeldeinformationen für Anwendungen mit gcloud auth application-default login ein.
2. Aktualisieren Sie Ihren KI-Assistenten (Claude Desktop/Cursor/Windsurf)

Verwendung

Wählen Sie zunächst ein Projekt aus oder stellen Sie Fragen wie:

• „Alle GCP-Projekte auflisten, auf die ich Zugriff habe“
• „Zeigen Sie mir alle Cloud SQL-Instanzen im Projekt X“
• „Wie ist mein aktueller Rechnungsstatus?“
• „Zeigen Sie mir die Protokolle meiner Cloud Run-Dienste“
• „Liste alle GKE-Cluster in us-central1 auf“
• „Zeigen Sie mir alle Cloud Storage-Buckets in Projekt X“
• „Welche Cloud-Funktionen werden in us-central1 bereitgestellt?“
• „Alle Cloud Run-Dienste auflisten“
• „Zeigen Sie mir BigQuery-Datensätze und -Tabellen“

Verfügbare Tools

1. run-gcp-code : Führen Sie GCP-API-Aufrufe mit TypeScript-Code aus
2. list-projects : Listet alle zugänglichen GCP-Projekte auf
3. select-project : Wählen Sie ein GCP-Projekt für nachfolgende Vorgänge aus
4. get-billing-info : Rechnungsinformationen für das aktuelle Projekt abrufen
5. get-cost-forecast : Kostenprognose für das aktuelle Projekt abrufen
6. get-billing-budget : Ruft die Abrechnungsbudgets für das aktuelle Projekt ab
7. list-gke-clusters : Listet alle GKE-Cluster im aktuellen Projekt auf
8. list-sql-instances : Listet alle Cloud SQL-Instanzen im aktuellen Projekt auf
9. get-logs : Ruft Cloud Logging-Einträge für das aktuelle Projekt ab

Beispielinteraktionen

1. Liste der verfügbaren Projekte:

2. Wählen Sie ein Projekt aus:

3. Rechnungsstatus prüfen:

4. Protokolle anzeigen:

Unterstützte Dienste

• Google Compute Engine
• Cloud-Speicher
• Cloud-Funktionen
• Cloud Run
• BigQuery
• Cloud SQL
• Google Kubernetes Engine (GKE)
• Cloud-Protokollierung
• Cloud-Abrechnung
• Ressourcenmanager
• Mehr folgt in Kürze ...

Fehlerbehebung

So zeigen Sie Protokolle an:

Häufige Probleme:

1. Authentifizierungsfehler: Stellen Sie sicher, dass Sie gcloud auth application-default login ausgeführt haben.
2. Berechtigungsfehler: Überprüfen Sie die IAM-Rollen für Ihr Konto
3. API-Fehler: Überprüfen Sie, ob die erforderlichen APIs in Ihrem Projekt aktiviert sind

Beitragen

Beiträge sind willkommen! Senden Sie gerne einen Pull Request.

Lizenz

MIT