1. Vorbereitung
Sie sollten Zugriff auf eine aktive Looker-Instanz haben. Sie benötigen eine API-Client-ID und einen Clientschlüssel.
Voraussetzungen
- Sie haben eine aktive Looker-Instanz.
- Zugriff auf eine Linux- oder macOS-Befehlszeile haben
Lerninhalte
- Gemini CLI installieren
- MCP-Toolbox installieren
- Gemini CLI mit der MCP-Toolbox mit Looker verbinden
Voraussetzungen
- Die URL des Looker API-Servers. Das ist in der Regel dieselbe URL wie die Looker-URL. Möglicherweise müssen Sie jedoch eine Portnummer wie
:19999anhängen, z. B.https://looker.example.com:19999. Wenn etwas nicht richtig funktioniert, wenden Sie sich an Ihren Looker-Administrator.
2. Vorbereitungen
Sie müssen eine client_id und einen client_secret abrufen.
Melden Sie sich in Ihrer Looker-Instanz an und klicken Sie rechts oben auf dem Bildschirm auf das Nutzerprofil. Wählen Sie Konto aus. Drücken Sie auf dem Bildschirm „Konto“ neben dem Label API Keys die Schaltfläche Manage.
Klicken Sie auf der Verwaltungsseite API-Schlüssel auf die Schaltfläche Create New API Key.
Fügen Sie dem neu erstellten Eintrag den Zweck MCP Toolbox oder etwas Ähnliches hinzu und klicken Sie auf das Häkchen, um ihn zu speichern. Kopieren Sie dann die client_id und den client_secret und fügen Sie sie an einem sicheren Ort ein. Sie müssen auf das Augensymbol neben dem Secret klicken, um es zu sehen und zu kopieren.
Sie können die Looker-Browserfenster jetzt schließen.
3. Gemini CLI installieren
Öffnen Sie die Terminal-App, um zur macOS- oder Linux-Befehlszeile zu gelangen.
Führen Sie dazu diesen Befehl aus:
npm install -g @google/gemini-cli
Sollte das aus irgendeinem Grund nicht funktionieren, finden Sie unter https://github.com/google-gemini/gemini-cli?tab=readme-ov-file#-installation Installationsoptionen oder Hilfe.
Führen Sie die Gemini CLI jetzt mit diesem Befehl aus:
gemini
Sie werden aufgefordert, sich anzumelden. Wenn Sie dieser Anleitung folgen, sollten Sie startklar sein.
4. MCP-Toolbox installieren
MCP-Toolbox-Verzeichnis erstellen
Erstellen Sie in Ihrer Terminal-App ein Verzeichnis mcp-toolbox. Wechseln Sie dann in dieses Verzeichnis:
mkdir $HOME/mcp-toolbox
cd $HOME/mcp-toolbox
Systemarchitektur ermitteln
Führen Sie den Befehl uname aus, um herauszufinden, welches System Sie verwenden:
uname -a
Dieser Befehl gibt einen String zurück, der in etwa so aussieht:
Linux hostname.example.com 6.16.12-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.16.12 (2025-11-10) x86_64 GNU/Linux
Achten Sie genau auf das Ende dieser Zeile. Wenn Sie Linux verwenden, endet der Pfad mit x86_64 GNU/Linux. Bei macOS wird Darwin und entweder arm64 für den Apple-Prozessor oder x86_64 i386 für den Intel-Prozessor am Ende dieses Strings angezeigt.
MCP-Toolbox herunterladen
Wenn Sie Linux verwenden, führen Sie den folgenden Befehl aus, um die MCP Toolbox herunterzuladen:
curl https://storage.googleapis.com/genai-toolbox/v0.26.0/linux/amd64/toolbox
Wenn Sie macOS mit einem Apple-Prozessor verwenden, führen Sie den folgenden Befehl aus, um die MCP Toolbox herunterzuladen:
curl https://storage.googleapis.com/genai-toolbox/v0.26.0/darwin/arm64/toolbox
Wenn Sie macOS mit einem Intel-Prozessor verwenden, führen Sie den folgenden Befehl aus, um die MCP Toolbox herunterzuladen:
curl https://storage.googleapis.com/genai-toolbox/v0.26.0/darwin/amd64/toolbox
MCP-Toolbox ausführbar machen
Machen Sie das MCP Toolbox-Programm ausführbar, indem Sie den folgenden Befehl ausführen:
chmod +x toolbox
Vollständigen Pfad zur Toolbox abrufen
Rufen Sie den vollständigen Pfad zur Toolbox-Datei mit dem folgenden Befehl ab:
echo $HOME/mcp-toolbox/toolbox
Das Ergebnis sieht dann wahrscheinlich so aus:
/home-or-User/YOUR-USER-NAME/mcp-toolbox/toolbox
Speichern Sie das Ergebnis an einem geeigneten Ort.
5. Gemini CLI konfigurieren
Bearbeiten Sie die Datei $HOME/.gemini/settings.json. Verwenden Sie Ihren bevorzugten Texteditor. Wenn Sie Dateien unter Linux oder macOS nicht sehr oft bearbeiten, ist nano eine gute Wahl.
Fügen Sie der JSON-Datei die folgende Stanza hinzu:
"mcpServers": {
"looker": {
"command": "FULL_PATH_TO_TOOLBOX",
"args": [
"--stdio",
"--prebuilt",
"looker"
],
"env": {
"LOOKER_BASE_URL": "URL_OF_LOOKER_INSTANCE",
"LOOKER_CLIENT_ID": "CLIENT_ID",
"LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
"LOOKER_VERIFY_SSL": "true"
}
}
}
Ersetzen Sie FULL_PATH_TO_TOOLBOX, URL_OF_LOOKER_INSTANCE, CLIENT_ID und CLIENT_SECRET durch die Informationen, die Sie in den vorherigen Schritten gespeichert haben. Speichern Sie die bearbeitete Datei.
6. MCP-Toolbox mit Gemini CLI verwenden
Starten Sie die Gemini CLI, indem Sie gemini in der Befehlszeile eingeben.
Geben Sie den folgenden Prompt in Gemini ein, um die verfügbaren Tools aufzulisten:
/mcp list looker
Das Ergebnis sollte in etwa so aussehen:
Configured MCP servers: 🟢 looker - Ready (33 tools) Tools: - add_dashboard_element - add_dashboard_filter - create_project_file - delete_project_file - dev_mode - generate_embed_url - get_connection_databases - get_connection_schemas - get_connection_table_columns - get_connection_tables - get_connections - get_dashboards - get_dimensions - get_explores - get_filters - get_looks - get_measures - get_models - get_parameters - get_project_file - get_project_files - get_projects - health_analyze - health_pulse - health_vacuum - make_dashboard - make_look - query - query_sql - query_url - run_dashboard - run_look - update_project_file
Fragen Sie die Gemini CLI nach den verfügbaren Daten. Probieren Sie Folgendes:
- Welche Modelle sind in Looker verfügbar?
- Welche Explores sind in MODEL_NAME verfügbar?
- Welche Messwerte und Dimensionen sind in EXPLORE_NAME verfügbar?
Ersetzen Sie MODEL_NAME und EXPLORE_NAME durch Ihre eigenen Werte.
Stellen Sie als Nächstes einige Fragen in natürlicher Sprache, die mit den Daten in Ihrer Looker-Instanz beantwortet werden können, z. B. „Wie hoch ist mein Gesamtumsatz für 2025?“, „Wie viele Widgets habe ich im 4. Quartal verkauft?“
7. Weitere Prompts zum Ausprobieren
Sie können auch versuchen, gespeicherte Looks und Dashboards auszuführen, Looks und Dashboards zu erstellen und sogar LookML-Modelle zu bearbeiten.
- Sie können einen gespeicherten Look ausführen, indem Sie einen Prompt wie „Führe den Look ‚Monatliches Inventar‘ aus“ eingeben. Gemini soll nach einem Look mit dem Namen „Monatlicher Inventarbericht“ suchen, dann die zugehörige Abfrage ausführen und die Ergebnisse teilen.
- Sie können ein Dashboard erstellen, indem Sie einen Prompt wie „Fasse das Dashboard ‚Kunden-Tracking‘ zusammen“ eingeben. Gemini soll nach einem Dashboard mit dem Namen „Kunden-Tracking“ suchen, die mit den einzelnen Kacheln verknüpften Abfragen ausführen und eine Zusammenfassung erstellen.
- Wenn Sie einen gespeicherten Look erstellen möchten, können Sie einen Prompt wie „Erstelle einen Look, um meinen monatlichen Umsatz nach Produktkategorie aufzuschlüsseln“ verwenden. Stelle die Daten als gestapeltes Säulendiagramm dar.“
- Wenn Sie ein Dashboard erstellen möchten, können Sie einen Prompt wie „Erstelle ein Dashboard für den Vertriebspuls für das Jahr 2026“ verwenden.
Als LookML-Entwickler können Sie LookML mit Gemini ändern. Probieren Sie Prompts wie diese aus:
- Fragen Sie Gemini nach der Liste der LookML-Projekte, indem Sie „Welche LookML-Projekte sind verfügbar?“ eingeben.
- Weisen Sie Gemini an, die Projektdateien abzurufen. „Welche Dateien sind im Projekt PROJECT_NAME verfügbar?“ Ersetzen Sie den Projektnamen durch Ihren eigenen.
- Fordern Sie Gemini auf, eine Measure hinzuzufügen. „Erstelle einen Messwert, um den Durchschnitt des Felds ‚sale_price‘ in der Ansicht VIEW_NAME zu berechnen.“ Ersetzen Sie den Namen der Ansicht durch Ihren eigenen.
- Rufen Sie die Liste der Verbindungen mit „Welche Verbindungen sind in Looker verfügbar?“ ab.
- Rufen Sie die zugehörigen Schemas ab. „Welche Schemas sind in CONNECTION_NAME?“ Ersetzen Sie den Namen der Verbindung durch Ihren eigenen.
- Die zugehörigen Tabellen abrufen. „Welche Tabellen sind in CONNECTION_NAME im Schema SCHEMA_NAME enthalten?“ Ersetzen Sie die Namen der Verbindung und des Schemas durch Ihre eigenen.
- Spalten für eine Tabelle abrufen. „Welche Spalten sind in TABLE_NAME enthalten?“ Ersetzen Sie den Tabellennamen durch Ihren eigenen.
- Bitten Sie Gemini nun, einer LookML-Ansicht eine Spalte hinzuzufügen. „Erstelle eine Dimension für die Spalte COLUMN_NAME.“ Ersetzen Sie den Spaltennamen durch Ihren eigenen.
Mit der Looker-Benutzeroberfläche können Sie die Änderungen testen und gegebenenfalls committen. Mit der Gemini- und MCP-Toolbox können keine LookML-Änderungen übernommen und in die Produktion übertragen werden.