Utilizzare Looker con MCP, l'interfaccia a riga di comando di Gemini e altri agenti

Questa pagina mostra come connettere l'istanza di Looker a vari strumenti per sviluppatori.

Per un'esperienza più potente e integrata, ti consigliamo di utilizzare l'estensione Looker dedicata per Gemini CLI. Utilizza il livello semantico di Looker per fornire alla CLI Gemini un accesso sicuro, controllato e on demand a dati attendibili e accelera i flussi di lavoro automatizzando la creazione di report, visualizzazioni e dashboard a partire da prompt in linguaggio naturale. In quanto interfaccia a riga di comando di nuova generazione di Google Cloud, la Gemini CLI è lo strumento consigliato per interagire con le istanze Looker dalla riga di comando.

Puoi anche connettere altri ambienti di sviluppo integrati (IDE) e strumenti per sviluppatori che supportano il Model Context Protocol (MCP) utilizzando MCP Toolbox for Databases per uso generico. MCP Toolbox è un server MCP open source che semplifica la connessione degli agenti AI ai tuoi dati gestendo complessità come l'autenticazione e il pool di connessioni, il che ti consente di interagire con i tuoi dati utilizzando il linguaggio naturale direttamente dal tuo IDE. Per questi strumenti, questo metodo fornisce le funzionalità di interazione di base con il database.

Informazioni sull'interfaccia a riga di comando di Gemini e sulle estensioni

Gemini CLI è un agente AI open source progettato per accelerare i flussi di lavoro di sviluppo aiutando con la programmazione, il debug, l'esplorazione dei dati e la creazione di contenuti. La sua missione è fornire un'esperienza agentica elegante per interagire con i servizi dati cloud e i database open source più diffusi.

Come funzionano le estensioni

Gemini CLI è altamente estensibile e consente l'aggiunta di nuovi strumenti e funzionalità tramite le estensioni. Queste estensioni sono facili da installare. Puoi caricarli da un URL GitHub, da una directory locale o da un registro configurabile. Queste estensioni forniscono un ricco insieme di funzionalità, tra cui nuovi strumenti, comandi slash e prompt per semplificare il workflow.

Configura Looker

1. Ottieni un ID client e un client secret di Looker. Segui le istruzioni riportate nella pagina della documentazione Autenticazione API Looker.
2. Avere a disposizione l'URL di base dell'istanza di Looker. Probabilmente è qualcosa di simile a https://looker.example.com. In alcuni casi, l'API è in ascolto su una porta diversa e dovrai utilizzare https://looker.example.com:19999.

Installare MCP Toolbox

1. Scarica l'ultima versione di MCP Toolbox come file binario. Seleziona il file binario corrispondente al tuo sistema operativo e all'architettura della CPU. Devi utilizzare MCP Toolbox versione V0.14.0 o successive.

   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. Rendi il binario un eseguibile.

   chmod +x toolbox
   

3. Verifica l'installazione.

   ./toolbox --version
   

Configura il client MCP

Questa sezione descrive come configurare vari strumenti per sviluppatori per connettersi all'istanza di Looker utilizzando MCP Toolbox for Databases. Il toolbox funge da server Model Context Protocol (MCP) open source che si trova tra l'IDE e il database, fornendo un piano di controllo sicuro ed efficiente per i tuoi strumenti di AI. Seleziona la scheda dello strumento specifico per visualizzare le istruzioni di configurazione.

• Interfaccia a riga di comando di Gemini
• Gemini Code Assist
• Claude code
• Claude desktop
• Cline (estensione VS Code)
• Cursore
• Visual Studio Code (Copilot)
• Windsurf (Codium)

      {
        "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",
          }
          }
        }
      }
  

      {
        "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",
          }
          }
        }
      }
  

      {
        "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",
          }
          }
        }
      }
  

      {
        "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",
          }
          }
        }
      }
  

      {
        "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",
          }
          }
        }
      }
  

      {
        "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",
          }
          }
        }
      }
  

Utilizzare gli strumenti di AI

Il tuo strumento di AI è ora connesso a Looker tramite MCP. Prova a chiedere all'assistente AI di elencare modelli, esplorazioni, dimensioni e misure. Puoi anche eseguire una query recuperando l'SQL per una query o eseguendo un Look salvato.

Sono disponibili i seguenti strumenti per il LLM:

• get_models: elenca tutti i modelli LookML nell'istanza Looker.
• get_explores: Elenca le esplorazioni in un determinato modello.
• get_dimensions: Elenca le dimensioni in una determinata esplorazione.
• get_measures: Elenca le misure in un'esplorazione specifica.
• get_filters: Elenca i filtri in un'esplorazione specifica.
• get_parameters: elenca i parametri in una determinata esplorazione.
• query: esegui una query e restituisci i dati.
• query_sql: restituisce l'SQL generato da Looker per una query.
• query_url: restituisce un link alla query in Looker per ulteriori esplorazioni.
• get_looks: restituisce i look salvati che corrispondono a un titolo o a una descrizione.
• run_look: esegui una Look salvata e restituisci i dati.
• make_look: crea un look salvato in Looker e restituisce l'URL.
• get_dashboards: restituisce i dashboard salvati che corrispondono a un titolo o a una descrizione.
• make_dashboard: crea una dashboard salvata in Looker e restituisce l'URL.
• add_dashboard_element: aggiungi un riquadro a una dashboard.