Looker mit MCP, Gemini CLI und anderen Agents verwenden

Auf dieser Seite wird beschrieben, wie Sie Ihre Looker-Instanz mit verschiedenen Entwicklertools verbinden.

Für eine optimale und integrierte Nutzung empfehlen wir die Verwendung der dedizierten Looker-Erweiterung für die Gemini CLI. Mit der semantischen Ebene von Looker können Sie der Gemini CLI sicheren, verwalteten und On-Demand-Zugriff auf vertrauenswürdige Daten ermöglichen und Workflows beschleunigen, indem Sie die Erstellung von Berichten, Visualisierungen und Dashboards aus Prompts in natürlicher Sprache automatisieren. Die Gemini CLI ist die Befehlszeilenschnittstelle der nächsten Generation von Google Cloud und das empfohlene Tool für die Interaktion mit Ihren Looker-Instanzen über die Befehlszeile.

Sie können auch andere integrierte Entwicklungsumgebungen (IDEs) und Entwicklertools, die das Model Context Protocol (MCP) unterstützen, über die universelle MCP Toolbox for Databases verbinden. Die MCP Toolbox ist ein Open-Source-MCP-Server, der die Verbindung von KI-Agenten mit Ihren Daten vereinfacht, indem er Komplexitäten wie die Authentifizierung und das Connection Pooling übernimmt. So können Sie direkt über Ihre IDE in natürlicher Sprache mit Ihren Daten interagieren. Für diese Tools bietet diese Methode grundlegende Funktionen für die Datenbankinteraktion.

Gemini CLI und Erweiterungen

Gemini CLI ist ein Open-Source-KI-Agent, der Entwicklungs-Workflows beschleunigen soll, indem er beim Programmieren, Debuggen, bei der Datenexploration und beim Erstellen von Inhalten unterstützt. Ziel ist es, eine elegante, auf Agenten basierende Möglichkeit zur Interaktion mit Data Cloud-Diensten und beliebten Open-Source-Datenbanken zu bieten.

So funktionieren Erweiterungen

Die Gemini CLI ist sehr flexibel und kann durch Erweiterungen um neue Tools und Funktionen ergänzt werden. Diese Erweiterungen lassen sich ganz einfach installieren. Sie können sie über eine GitHub-URL, ein lokales Verzeichnis oder eine konfigurierbare Registry laden. Diese Erweiterungen bieten eine Vielzahl von Funktionen, darunter neue Tools, Slash-Befehle und Prompts, mit denen Sie Ihren Workflow optimieren können.

Looker einrichten

1. Rufen Sie eine Looker-Client-ID und einen Looker-Clientschlüssel ab. Folgen Sie der Anleitung auf der Dokumentationsseite Looker API-Authentifizierung.
2. Die Basis-URL Ihrer Looker-Instanz muss verfügbar sein. Wahrscheinlich ist es etwas wie https://looker.example.com. In einigen Fällen wird die API an einem anderen Port überwacht. In diesem Fall müssen Sie https://looker.example.com:19999 verwenden.

MCP-Toolbox installieren

Hinweis :Wenn Sie die Gemini CLI oder Gemini Code Assist verwenden, um über die MCP Toolbox for Databases eine Verbindung zu Ihrer Looker-Instanz herzustellen, müssen Sie die MCP Toolbox nicht installieren. Die MCP-Toolbox wird installiert, wenn die Gemini-Erweiterung während des Konfigurationsschritts installiert wird.

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 V0.14.0 oder höher verwenden.

   linux/amd64

   curl -O https://storage.googleapis.com/genai-toolbox/v0.14.0/linux/amd64/toolbox
   
   

   darwin/arm64

   curl -O https://storage.googleapis.com/genai-toolbox/v0.14.0/darwin/arm64/toolbox
   
   

   darwin/amd64

   curl -O https://storage.googleapis.com/genai-toolbox/v0.14.0/darwin/amd64/toolbox
   
   

   windows/amd64

   curl -O https://storage.googleapis.com/genai-toolbox/v0.14.0/windows/amd64/toolbox.exe
   
   

2. Machen Sie das Binärprogramm ausführbar.

   chmod +x toolbox
   

3. Prüfen Sie die Installation.

   ./toolbox --version
   

MCP-Client konfigurieren

In diesem Abschnitt wird beschrieben, wie Sie verschiedene Entwicklertools so konfigurieren, dass sie mit der MCP Toolbox for Databases eine Verbindung zu Ihrer Looker-Instanz herstellen. Die Toolbox fungiert als Open-Source-Server für das Model Context Protocol (MCP), der sich zwischen Ihrer IDE und Ihrer Datenbank befindet und eine sichere und effiziente Steuerungsebene für Ihre KI-Tools bietet. Wählen Sie den Tab für das jeweilige Tool aus, um die Konfigurationsanleitung aufzurufen.

• Gemini CLI
• Gemini Code Assist
• Claude Code
• Claude für Desktop
• Cline (VS Code-Erweiterung)
• Cursor
• Visual Studio Code (Copilot)
• Windsurf (Codium)

Gemini-Befehlszeile

1. Installieren Sie die Gemini-Befehlszeile.
2. Installieren Sie die Looker-Erweiterung für die Gemini CLI aus dem GitHub-Repository mit dem folgenden Befehl:

   gemini extensions install https://github.com/gemini-cli-extensions/looker
   

3. Legen Sie Umgebungsvariablen fest, um eine Verbindung zu Ihrer Looker-Instanz herzustellen. Ersetzen Sie die folgenden Umgebungsvariablen durch Ihre Werte:
   • LOOKER_URL: Die URL Ihrer Looker-Instanz.
   • CLIENT_ID und CLIENT_SECRET: Der API-Schlüssel, der für den Zugriff auf die Looker API verwendet wird.
   • VERIFY_SSL: Entweder true oder false, je nachdem, ob Sie SSL-Verschlüsselung verwenden, um Ihre Datenbank mit Ihrer Looker-Instanz zu verbinden.

   export LOOKER_BASE_URL="LOOKER_URL"
   export LOOKER_CLIENT_ID="CLIENT_ID"
   export LOOKER_CLIENT_SECRET="CLIENT_SECRET"
   export LOOKER_VERIFY_SSL="VERIFY_SSL"
   

4. Starten Sie die Gemini CLI im interaktiven Modus:

   gemini
   

   Die CLI lädt automatisch die Looker-Erweiterung für die Gemini CLI-Erweiterung und ihre Tools, mit denen Sie mit Ihrer Looker-Instanz interagieren können.

Gemini Code Assist

Wir empfehlen, Gemini Code Assist für die Verwendung der Gemini-Befehlszeile zu konfigurieren. Bei diesem Ansatz muss kein MCP-Server manuell konfiguriert werden.

1. Prüfen Sie, ob die Gemini-Befehlszeile und die looker-Erweiterung installiert und konfiguriert sind.
2. Gemini Code Assist für die Verwendung der Gemini CLI konfigurieren
3. Sie können direkt im Gemini Code Assist-Chat mit Ihrer Looker-Instanz interagieren.

Claude-Code

1. Installieren Sie Claude Code.
2. Erstellen Sie im Stammverzeichnis Ihres Projekts die Datei .mcp.json, falls sie noch nicht vorhanden ist.
3. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie die folgenden Umgebungsvariablen durch Ihre Werte und speichern Sie die Datei.
   • LOOKER_URL: Die URL Ihrer Looker-Instanz.
   • CLIENT_ID und CLIENT_SECRET: Der API-Schlüssel, der für den Zugriff auf die Looker API verwendet wird.
   • VERIFY_SSL: Entweder true oder false, je nachdem, ob Sie SSL-Verschlüsselung verwenden, um Ihre Datenbank mit Ihrer Looker-Instanz zu verbinden.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }
  

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 folgende Konfiguration hinzu, ersetzen Sie die folgenden Umgebungsvariablen durch Ihre Werte und speichern Sie die Datei.
   • LOOKER_URL: Die URL Ihrer Looker-Instanz.
   • CLIENT_ID und CLIENT_SECRET: Der API-Schlüssel, der für den Zugriff auf die Looker API verwendet wird.
   • VERIFY_SSL: Entweder true oder false, je nachdem, ob Sie SSL-Verschlüsselung verwenden, um Ihre Datenbank mit Ihrer Looker-Instanz zu verbinden.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }
  

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 folgenden Umgebungsvariablen durch Ihre Werte und speichern Sie die Datei.
   • LOOKER_URL: Die URL Ihrer Looker-Instanz.
   • CLIENT_ID und CLIENT_SECRET: Der API-Schlüssel, der für den Zugriff auf die Looker API verwendet wird.
   • VERIFY_SSL: Entweder true oder false, je nachdem, ob Sie SSL-Verschlüsselung verwenden, um Ihre Datenbank mit Ihrer Looker-Instanz zu verbinden.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }
  

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 folgenden Umgebungsvariablen durch Ihre Werte und speichern Sie die Datei.
   • LOOKER_URL: Die URL Ihrer Looker-Instanz.
   • CLIENT_ID und CLIENT_SECRET: Der API-Schlüssel, der für den Zugriff auf die Looker API verwendet wird.
   • VERIFY_SSL: Entweder true oder false, je nachdem, ob Sie SSL-Verschlüsselung verwenden, um Ihre Datenbank mit Ihrer Looker-Instanz zu verbinden.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }
  

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 folgenden Umgebungsvariablen durch Ihre Werte und speichern Sie die Datei.
   • LOOKER_URL: Die URL Ihrer Looker-Instanz.
   • CLIENT_ID und CLIENT_SECRET: Der API-Schlüssel, der für den Zugriff auf die Looker API verwendet wird.
   • VERIFY_SSL: Entweder true oder false, je nachdem, ob Sie SSL-Verschlüsselung verwenden, um Ihre Datenbank mit Ihrer Looker-Instanz zu verbinden.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }
  

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 folgenden Umgebungsvariablen durch Ihre Werte und speichern Sie die Datei.
   • LOOKER_URL: Die URL Ihrer Looker-Instanz.
   • CLIENT_ID und CLIENT_SECRET: Der API-Schlüssel, der für den Zugriff auf die Looker API verwendet wird.
   • VERIFY_SSL: Entweder true oder false, je nachdem, ob Sie SSL-Verschlüsselung verwenden, um Ihre Datenbank mit Ihrer Looker-Instanz zu verbinden.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }
  

KI‑Tools verwenden

Ihr KI-Tool ist jetzt über MCP mit Looker verbunden. Bitten Sie Ihren KI-Assistenten, Modelle, Explores, Dimensionen und Messwerte aufzulisten. Sie können auch eine Abfrage ausführen, indem Sie den SQL-Code für eine Abfrage abrufen oder einen gespeicherten Look ausführen.

Dem LLM stehen die folgenden Tools zur Verfügung:

Looker-Modell- und Abfragetools

Mit diesen Tools können Sie Informationen zu einem Looker-Modell abrufen und Abfragen für dieses Modell ausführen.

• get_models: Alle LookML-Modelle in Ihrer Looker-Instanz auflisten.
• get_explores: Listet die Explores in einem bestimmten Modell auf.
• get_dimensions: Listet die Dimensionen in einem bestimmten Explore auf.
• get_measures: Listet die Messwerte in einem bestimmten Explore auf.
• get_filters: Listet die Filter in einem bestimmten Explore auf.
• get_parameters: Listet die Parameter in einem bestimmten Explore auf.
• query: Führt eine Abfrage aus und gibt die Daten zurück.
• query_sql: Gibt das SQL zurück, das von Looker für eine Abfrage generiert wird.
• query_url: Gibt einen Link zur Abfrage in Looker zurück, damit Sie sie weiter untersuchen können.

Looker Content Tools

Mit diesen Tools werden gespeicherte Inhalte (Looks und Dashboards) aus einer Looker-Instanz abgerufen und neue gespeicherte Inhalte erstellt.

• get_looks: Gibt die gespeicherten Looks zurück, die einem Titel oder einer Beschreibung entsprechen.
• run_look: Führt einen gespeicherten Look aus und gibt die Daten zurück.
• make_look: Erstellt einen gespeicherten Look in Looker und gibt die URL zurück.
• get_dashboards: Gibt die gespeicherten Dashboards zurück, die einem Titel oder einer Beschreibung entsprechen.
• make_dashboard: Erstelle ein gespeichertes Dashboard in Looker und gib die URL zurück.
• add_dashboard_element: Fügen Sie einem Dashboard eine Kachel hinzu.

Tools für den Looker-Instanzzustand

Diese Tools bieten dieselben Systemdiagnosealgorithmen wie die beliebte CLI Henry.

• health_pulse: Den Zustand einer Looker-Instanz prüfen.
• health_analyze: Die Verwendung eines Looker-Objekts analysieren.
• health_vacuum: LookML-Elemente finden, die möglicherweise nicht verwendet werden.

LookML-Authoring-Tools

Mit diesen Tools kann der Aufrufer LookML-Dateien schreiben und ändern sowie das für das effektive Schreiben von LookML erforderliche Datenbankschema abrufen.

• dev_mode: Aktivieren und deaktivieren Sie den Entwicklermodus für die Sitzung. LookML-Code muss im Entwicklermodus erstellt werden. Bei Abfragen, die im Entwicklermodus ausgeführt werden, wird die geänderte LookML verwendet. So können Sie die Auswirkungen Ihrer Änderungen testen.
• get_projects: Ruft die Liste der verfügbaren LookML-Projekte ab.
• get_project_files: Ruft die Liste der LookML-Dateien in einem Projekt ab.
• get_project_file: Ruft den Inhalt einer LookML-Datei ab.
• create_project_file: Erstellen Sie eine neue LookML-Datei.
• update_project_file: Eine vorhandene LookML-Datei ändern.
• delete_project_file: Eine LookML-Datei löschen.
• get_connections: Ruft die Liste der Verbindungen ab.
• get_connection_schemas: Ruft die Liste der Schemas für eine Verbindung ab.
• get_connection_databases: Ruft die Liste der Datenbanken für eine Verbindung ab.
• get_connection_tables: Ruft die Liste der Tabellen für eine Verbindung ab.
• get_connection_table_columns: Ruft die Liste der Spalten für eine Tabelle in einer Verbindung ab.

Hinweis :Vorgefertigte Tools sind vor Version 1.0, daher sind einige Tooländerungen zwischen den Versionen zu erwarten. Da LLMs sich an die verfügbaren Tools anpassen, sind die meisten Nutzer nicht betroffen.