1. Zanim zaczniesz
Musisz mieć dostęp do działającej instancji Lookera. Będziesz potrzebować identyfikatora klienta API (client_id) i tajnego klucza klienta (client_secret).
Wymagania wstępne
- mieć uruchomioną instancję Lookera,
- mieć dostęp do wiersza poleceń w systemie Linux lub macOS;
Czego się nauczysz
- Jak zainstalować interfejs wiersza poleceń Gemini
- Jak zainstalować zestaw narzędzi MCP
- Jak połączyć interfejs wiersza poleceń Gemini z Lookerem za pomocą MCP Toolbox
Czego potrzebujesz
- Adres URL serwera interfejsu Looker API. Zwykle jest to ten sam adres URL co adres Lookera, ale może być konieczne dodanie numeru portu, np.
:19999, na przykład:https://looker.example.com:19999. Jeśli coś nie działa prawidłowo, skontaktuj się z administratorem Lookera.
2. Przygotowania
Musisz pobrać identyfikator klienta i tajny klucz klienta.
Zaloguj się w instancji Lookera i kliknij profil użytkownika w prawym górnym rogu ekranu. Wybierz Konto. Na ekranie Konto obok etykiety API Keys naciśnij przycisk Manage.
Na stronie zarządzania kluczami interfejsów API kliknij przycisk Create New API Key.
W nowo utworzonym wpisie dodaj cel MCP Toolbox lub podobny tekst i kliknij znacznik wyboru, aby go zapisać. Następnie skopiuj i wklej identyfikator klienta i tajny klucz klienta w bezpiecznym miejscu. Aby wyświetlić i skopiować tajny klucz, musisz kliknąć ikonę oka obok niego.
Możesz teraz zamknąć okna przeglądarki Looker.
3. Instalowanie interfejsu wiersza poleceń Gemini
Otwórz aplikację terminala, aby przejść do wiersza poleceń macOS lub Linux.
Uruchom to polecenie:
npm install -g @google/gemini-cli
Jeśli z jakiegoś powodu instalacja się nie powiedzie, na stronie https://github.com/google-gemini/gemini-cli?tab=readme-ov-file#-installation znajdziesz opcje instalacji i pomoc.
Teraz uruchom interfejs wiersza poleceń Gemini za pomocą tego polecenia:
gemini
Pojawi się prośba o zalogowanie się. Postępuj zgodnie z tymi instrukcjami, a będziesz gotowy(-a).
4. Instalowanie MCP Toolbox
Utwórz katalog Zestaw narzędzi MCP
W aplikacji terminala utwórz katalog mcp-toolbox. Następnie przejdź do tego katalogu:
mkdir $HOME/mcp-toolbox
cd $HOME/mcp-toolbox
Określanie architektury systemu
Uruchom polecenie uname, aby sprawdzić, jakiego systemu używasz:
uname -a
To polecenie zwróci ciąg znaków podobny do tego:
Linux hostname.example.com 6.16.12-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.16.12 (2025-11-10) x86_64 GNU/Linux
Zwróć szczególną uwagę na koniec tego wiersza. Jeśli korzystasz z Linuksa, na końcu pojawi się x86_64 GNU/Linux. W przypadku systemu macOS na końcu tego ciągu znaków pojawi się symbol Darwin oraz arm64 (procesor Apple) lub x86_64 i386 (procesor Intel).
Pobierz Zestaw narzędzi MCP
Jeśli masz system Linux, uruchom to polecenie, aby pobrać MCP Toolbox:
curl https://storage.googleapis.com/genai-toolbox/v0.26.0/linux/amd64/toolbox
Jeśli masz macOS z procesorem Apple, uruchom to polecenie, aby pobrać MCP Toolbox:
curl https://storage.googleapis.com/genai-toolbox/v0.26.0/darwin/arm64/toolbox
Jeśli masz macOS z procesorem Intel, uruchom to polecenie, aby pobrać MCP Toolbox:
curl https://storage.googleapis.com/genai-toolbox/v0.26.0/darwin/amd64/toolbox
Uruchamianie Zestawu narzędzi MCP
Uruchom program MCP Toolbox, wykonując to polecenie:
chmod +x toolbox
Uzyskiwanie pełnej ścieżki do narzędzi
Aby uzyskać pełną ścieżkę do pliku narzędziowego, uruchom to polecenie:
echo $HOME/mcp-toolbox/toolbox
Prawdopodobnie otrzymasz coś takiego:
/home-or-User/YOUR-USER-NAME/mcp-toolbox/toolbox
Zapisz wynik w dogodnym miejscu.
5. Konfigurowanie interfejsu wiersza poleceń Gemini
Edytuj plik $HOME/.gemini/settings.json. Użyj preferowanego edytora tekstu. Jeśli nie edytujesz często plików w systemie Linux lub macOS, nano to dobry wybór.
Dodaj do pliku JSON ten fragment:
"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"
}
}
}
Zastąp zmienne FULL_PATH_TO_TOOLBOX, URL_OF_LOOKER_INSTANCE, CLIENT_ID i CLIENT_SECRET informacjami zapisanymi w poprzednich krokach. Zapisz zmieniony plik.
6. Korzystanie z MCP Toolbox z interfejsem wiersza poleceń Gemini
Uruchom interfejs wiersza poleceń Gemini, wpisując gemini w wierszu poleceń.
Aby wyświetlić listę dostępnych narzędzi, wpisz w prompt dla Gemini:
/mcp list looker
Wynik powinien wyglądać mniej więcej tak:
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
Teraz zacznij zadawać interfejsowi wiersza poleceń Gemini pytania o dostępne dane. Wypróbuj te sposoby:
- Jakie modele są dostępne w Lookerze?
- Jakie eksploracje są dostępne w MODEL_NAME?
- Jakie dane i wymiary są dostępne w usłudze EXPLORE_NAME?
Zastąp wartości MODEL_NAME i EXPLORE_NAME własnymi wartościami.
Następnie spróbuj zadać kilka zapytań w języku naturalnym, na które można odpowiedzieć na podstawie danych w instancji Lookera: „Jakie są moje łączne przychody w 2025 r.?”, „Ile widżetów udało mi się sprzedać w IV kwartale?” itp.
7. Więcej promptów do wypróbowania
Możesz też uruchamiać zapisane ujęcia i panele, tworzyć ujęcia i panele, a nawet edytować modele LookML.
- Uruchom zapisane ujęcie, wpisując prompt, np. „Uruchom ujęcie „Miesięczne zasoby”. Gemini powinna wyszukać widok o nazwie „Monthly Inventory”, a następnie uruchomić powiązane z nim zapytanie i udostępnić wyniki.
- Uruchom panel, wpisując prompt, np. „Podsumuj panel „Śledzenie klientów””. Gemini ma wyszukać panel o nazwie „śledzenie klientów”, uruchomić zapytania powiązane z każdym kafelkiem i podać podsumowanie.
- Aby utworzyć zapisany Look, wypróbuj prompta w stylu „Utwórz Looka, który będzie śledzić moje miesięczne przychody z podziałem na kategorie produktów”. Wyświetl dane w postaci skumulowanego wykresu kolumnowego”.
- Aby utworzyć panel, wypróbuj prompta „Utwórz panel z informacjami o sprzedaży w 2026 roku”.
Jeśli jesteś deweloperem LookML, możesz modyfikować LookML za pomocą Gemini. Wypróbuj prompty takie jak te:
- Poproś Gemini o wyświetlenie listy projektów LookML, wpisując „Jakie projekty LookML są dostępne?”.
- Poproś Gemini o pobranie listy plików projektu. „Jakie pliki są dostępne w projekcie PROJECT_NAME?” Zastąp nazwę projektu własną nazwą.
- Poproś Gemini o dodanie miary. „Utwórz miarę, która oblicza średnią wartość pola sales_price w widoku VIEW_NAME”. Zastąp nazwę widoku własną nazwą.
- Pobierz listę połączeń za pomocą artykułu „Jakie połączenia są dostępne w Lookerze?”.
- Pobierz powiązane schematy. „Jakie schematy są w CONNECTION_NAME?” Zastąp nazwę połączenia własną nazwą.
- Pobierz powiązane tabele. „Jakie tabele znajdują się w CONNECTION_NAME w schemacie SCHEMA_NAME?” Zastąp nazwy połączenia i schematu własnymi nazwami.
- Pobierz kolumny tabeli. „Jakie kolumny znajdują się w tabeli TABLE_NAME?” Zastąp nazwę tabeli własną nazwą.
- Teraz zapytaj Gemini o dodanie kolumny do widoku LookML. „Utwórz wymiar dla kolumny COLUMN_NAME”. Zastąp nazwę kolumny własną nazwą.
Użyj interfejsu Lookera, aby przetestować zmiany i ewentualnie je zatwierdzić. Narzędzia Gemini i MCP nie mogą zatwierdzać zmian w LookML ani wdrażać ich w środowisku produkcyjnym.