Usar Looker con MCP, Gemini CLI y otros agentes

En esta página se explica cómo conectar tu instancia de Looker a varias herramientas para desarrolladores.

Para disfrutar de la experiencia más potente e integrada, te recomendamos que uses la extensión de Looker específica para Gemini CLI. Usa la capa semántica de Looker para proporcionar a la CLI de Gemini acceso seguro, controlado y bajo demanda a datos fiables, así como para agilizar los flujos de trabajo automatizando la creación de informes, visualizaciones y paneles de control a partir de peticiones de lenguaje natural. La CLI de Gemini es la interfaz de línea de comandos de nueva generación de Google Cloud y la herramienta recomendada para interactuar con tus instancias de Looker desde la línea de comandos.

También puedes conectar otros entornos de desarrollo integrados (IDEs) y herramientas para desarrolladores que admitan el Model Context Protocol (MCP) mediante la MCP Toolbox for Databases de uso general. MCP Toolbox es un servidor MCP de código abierto que simplifica la conexión de agentes de IA a tus datos al gestionar complejidades como la autenticación y la agrupación de conexiones, lo que te permite interactuar con tus datos mediante lenguaje natural directamente desde tu IDE. En el caso de estas herramientas, este método proporciona funciones básicas de interacción con la base de datos.

Acerca de Gemini CLI y las extensiones

Gemini CLI es un agente de IA de código abierto diseñado para acelerar los flujos de trabajo de desarrollo, ya que ayuda con la programación, la depuración, la exploración de datos y la creación de contenido. Su misión es proporcionar una experiencia de agente elegante para interactuar con servicios de nube de datos y bases de datos de código abierto populares.

Cómo funcionan las extensiones

La CLI de Gemini es muy extensible, lo que permite añadir nuevas herramientas y funciones mediante extensiones. Estas extensiones son fáciles de instalar. Puedes cargarlos desde una URL de GitHub, un directorio local o un registro configurable. Estas extensiones ofrecen un amplio conjunto de funciones, como nuevas herramientas, comandos de barra y peticiones para optimizar tu flujo de trabajo.

Configurar Looker

1. Obtén un ID de cliente y un secreto de cliente de Looker. Sigue las instrucciones de la página de documentación sobre la autenticación de la API de Looker.
2. Tener disponible la URL base de tu instancia de Looker. Es probable que sea algo parecido a https://looker.example.com. En algunos casos, la API está escuchando en un puerto diferente y tendrás que usar https://looker.example.com:19999.

Instalar MCP Toolbox

1. Descarga la última versión de MCP Toolbox como archivo binario. Selecciona el binario que corresponda a tu sistema operativo y a la arquitectura de tu CPU. Debes usar la versión V0.14.0 o una posterior de MCP Toolbox.

   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. Convierte el binario en un archivo ejecutable.

   chmod +x toolbox
   

3. Verifica la instalación.

   ./toolbox --version
   

Configurar el cliente de MCP

En esta sección se describe cómo configurar varias herramientas para desarrolladores para conectarse a tu instancia de Looker mediante MCP Toolbox for Databases. Esta caja de herramientas actúa como un servidor Model Context Protocol (MCP) de código abierto que se encuentra entre tu IDE y tu base de datos, y proporciona un plano de control seguro y eficiente para tus herramientas de IA. Selecciona la pestaña de la herramienta en cuestión para ver las instrucciones de configuración.

• Gemini CLI
• Gemini Code Assist
• Código de Claude
• Claude para ordenadores
• Cline (extensión de VS Code)
• Cursor
• 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",
          }
          }
        }
      }
  

Usar herramientas de IA

Tu herramienta de IA ahora está conectada a Looker mediante MCP. Prueba a pedirle a tu asistente de IA que te muestre los modelos, los Exploraciones, las dimensiones y las medidas. También puedes ejecutar una consulta obteniendo el código SQL de una consulta o ejecutando un Look guardado.

El LLM tiene acceso a las siguientes herramientas:

• get_models: muestra todos los modelos de LookML de tu instancia de Looker.
• get_explores: muestra los explores de un modelo concreto.
• get_dimensions: muestra las dimensiones de una exploración determinada.
• get_measures: enumera las medidas de una exploración determinada.
• get_filters: muestra los filtros de una Exploración determinada.
• get_parameters: muestra los parámetros de una exploración determinada.
• query: ejecuta una consulta y devuelve los datos.
• query_sql: devuelve el SQL que genera Looker para una consulta.
• query_url: devuelve un enlace a la consulta en Looker para que puedas seguir investigando.
• get_looks: devuelve los Looks guardados que coincidan con un título o una descripción.
• run_look: ejecuta un Look guardado y devuelve los datos.
• make_look: crea una vista guardada en Looker y devuelve la URL.
• get_dashboards: devuelve los paneles de control guardados que coincidan con un título o una descripción.
• make_dashboard: crea un panel de control guardado en Looker y devuelve la URL.
• add_dashboard_element: añade una tarjeta a un panel de control.