此页面由 Cloud Translation API 翻译。

将 Looker 与 MCP、Gemini CLI 和其他代理搭配使用

本页介绍了如何将 Looker 实例连接到各种开发者工具。

为了获得最强大且集成式的体验，我们建议使用专用的 Looker 扩展程序来搭配 Gemini CLI。使用 Looker 的语义层为 Gemini CLI 提供对可信数据的安全、受监管的按需访问权限，并通过自动根据自然语言提示创建报告、可视化图表和信息中心来加快工作流程。作为 Google Cloud 的新一代命令行界面，Gemini CLI 是从命令行与 Looker 实例交互的推荐工具。

您还可以使用通用型 MCP Toolbox for Databases 连接支持 Model Context Protocol (MCP) 的其他集成开发环境 (IDE) 和开发者工具。MCP Toolbox 是一款开源 MCP 服务器，可通过处理身份验证和连接池等复杂问题，简化将 AI 智能体连接到数据的过程，让您可以直接通过 IDE 使用自然语言与数据进行交互。对于这些工具，此方法可提供核心数据库互动功能。

Gemini CLI 和扩展程序简介

Gemini CLI 是一款开源 AI 智能体，旨在通过协助编码、调试、数据探索和内容创建来加速开发工作流。其使命是提供优雅的智能体体验，以便与数据云服务和热门的开源数据库进行互动。

扩展程序的运作方式

Gemini CLI 具有高度可扩展性，可通过扩展程序添加新工具和功能。这些扩展程序安装起来非常简单。您可以从 GitHub 网址、本地目录或可配置的注册数据库中加载它们。这些扩展程序提供丰富的功能，包括新的工具、斜杠命令和提示，可帮助您简化工作流程。

设置 Looker

获取 Looker 客户端 ID 和客户端密钥。请按照 Looker API 身份验证文档页面上的说明操作。
准备好 Looker 实例的基础网址。它可能类似于 https://looker.example.com。在某些情况下，API 会在其他端口上监听，您需要改用 https://looker.example.com:19999。

安装 MCP Toolbox

以二进制文件形式下载最新版本的 MCP Toolbox。选择与您的操作系统和 CPU 架构对应的二进制文件。您必须使用 MCP Toolbox V0.14.0 版或更高版本。

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

将该二进制文件设为可执行文件。
```
chmod +x toolbox
```
验证安装。
```
./toolbox --version
```

配置 MCP 客户端

本部分介绍了如何配置各种开发者工具，以便使用 MCP Toolbox for Databases 连接到 Looker 实例。该工具箱充当位于 IDE 和数据库之间的开源 Model Context Protocol (MCP) 服务器，为 AI 工具提供安全高效的控制平面。选择特定工具的标签页，以查看配置说明。

Gemini CLI
Gemini Code Assist
Claude code
Claude Desktop
Cline（VS Code 扩展程序）
Cursor
Visual Studio Code (Copilot)
Windsurf (Codium)

Gemini CLI

安装 Gemini CLI。
使用以下命令从 GitHub 代码库安装适用于 Gemini CLI 的 Looker 扩展程序：
```
gemini extensions install https://github.com/gemini-cli-extensions/looker
```
设置环境变量以连接到 Looker 实例，并将以下环境变量替换为您的值：
- LOOKER_URL：Looker 实例的网址。
- CLIENT_ID 和 CLIENT_SECRET：用于访问 Looker API 的 API 密钥。
- VERIFY_SSL：true 或 false，具体取决于您是否使用 SSL 加密将数据库连接到 Looker 实例。
```
export LOOKER_BASE_URL="LOOKER_URL"
export LOOKER_CLIENT_ID="CLIENT_ID"
export LOOKER_CLIENT_SECRET="CLIENT_SECRET"
export LOOKER_VERIFY_SSL="VERIFY_SSL"
```
以互动模式启动 Gemini CLI：
```
gemini
```
该 CLI 会自动加载适用于 Gemini CLI 的 Looker 扩展程序及其工具，您可以使用这些工具与 Looker 实例进行交互。

Gemini Code Assist

我们建议您将 Gemini Code Assist 配置为使用 Gemini CLI。此方法无需手动配置 MCP 服务器。

确保您已安装并配置 Gemini CLI 和 looker 扩展程序。
配置 Gemini Code Assist 以使用 Gemini CLI。
直接在 Gemini Code Assist 对话窗口中使用自然语言开始与 Looker 实例互动。

Claude Code

安装 Claude Code。
在项目根目录中创建 .mcp.json 目录（如果尚不存在）。
添加以下配置，将以下环境变量替换为您的值，然后保存。
- LOOKER_URL：Looker 实例的网址。
- CLIENT_ID 和 CLIENT_SECRET：用于访问 Looker API 的 API 密钥。
- VERIFY_SSL：true 或 false，具体取决于您是否使用 SSL 加密将数据库连接到 Looker 实例。

      {
        "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 Desktop

打开 Claude Desktop，然后前往设置。
在开发者标签页中，点击修改配置以打开配置文件。
添加以下配置，将以下环境变量替换为您的值，然后保存。
- LOOKER_URL：Looker 实例的网址。
- CLIENT_ID 和 CLIENT_SECRET：用于访问 Looker API 的 API 密钥。
- VERIFY_SSL：true 或 false，具体取决于您是否使用 SSL 加密将数据库连接到 Looker 实例。

      {
        "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 Desktop。
新聊天界面会显示锤子 (MCP) 图标以及新的 MCP 服务器。

Cline

在 VS Code 中打开 Cline 扩展程序，然后点击 MCP 服务器图标。
点击配置 MCP 服务器以打开配置文件。
添加以下配置，将以下环境变量替换为您的值，然后保存。
- LOOKER_URL：Looker 实例的网址。
- CLIENT_ID 和 CLIENT_SECRET：用于访问 Looker API 的 API 密钥。
- VERIFY_SSL：true 或 false，具体取决于您是否使用 SSL 加密将数据库连接到 Looker 实例。

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

服务器成功连接后，系统会显示绿色的活跃状态。

光标

在项目根目录中创建 .cursor 目录（如果尚不存在）。
创建 .cursor/mcp.json 文件（如果尚不存在）并打开该文件。
添加以下配置，将以下环境变量替换为您的值，然后保存。
- LOOKER_URL：Looker 实例的网址。
- CLIENT_ID 和 CLIENT_SECRET：用于访问 Looker API 的 API 密钥。
- VERIFY_SSL：true 或 false，具体取决于您是否使用 SSL 加密将数据库连接到 Looker 实例。

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

打开 Cursor，然后依次前往设置 > Cursor 设置 > MCP。服务器连接时，系统会显示绿色的活跃状态。

Visual Studio Code (Copilot)

打开 VS Code，并在项目根目录中创建 .vscode 目录（如果尚不存在）。
创建 .vscode/mcp.json 文件（如果尚不存在）并打开该文件。
添加以下配置，将以下环境变量替换为您的值，然后保存。
- LOOKER_URL：Looker 实例的网址。
- CLIENT_ID 和 CLIENT_SECRET：用于访问 Looker API 的 API 密钥。
- VERIFY_SSL：true 或 false，具体取决于您是否使用 SSL 加密将数据库连接到 Looker 实例。

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

打开 Windsurf 并前往 Cascade 助理。
点击 MCP 图标，然后点击配置以打开配置文件。
添加以下配置，将以下环境变量替换为您的值，然后保存。
- LOOKER_URL：Looker 实例的网址。
- CLIENT_ID 和 CLIENT_SECRET：用于访问 Looker API 的 API 密钥。
- VERIFY_SSL：true 或 false，具体取决于您是否使用 SSL 加密将数据库连接到 Looker 实例。

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

使用 AI 工具

您的 AI 工具现在已使用 MCP 连接到 Looker。尝试让 AI 助理列出模型、探索、维度和度量。您还可以通过检索查询的 SQL 或运行已保存的 Look 来运行查询。

LLM 可使用以下工具：

Looker 模型和查询工具

这些工具用于获取 Looker 模型的相关信息，并针对该模型执行查询。

get_models：列出 Looker 实例上的所有 LookML 模型。
get_explores：列出给定模型中的探索。
get_dimensions：列出指定探索中的维度。
get_measures：列出指定探索中的度量。
get_filters：列出指定探索中的过滤条件。
get_parameters：列出指定探索中的参数。
query：运行查询并返回数据。
query_sql：返回 Looker 为查询生成的 SQL。
query_url：返回指向 Looker 中查询的链接，以便进一步探索。

Looker 内容工具

这些工具从 Looker 实例获取已保存的内容（Look 和信息中心），并创建新的已保存内容。

get_looks：返回与指定标题或说明匹配的已保存的 Look。
run_look：运行已保存的 Look 并返回数据。
make_look：在 Looker 中创建已保存的 Look 并返回网址。
get_dashboards：返回与指定标题或说明匹配的已保存信息中心。
make_dashboard：在 Looker 中创建已保存的信息中心并返回网址。
add_dashboard_element：向信息中心添加卡片。

Looker 实例健康状况工具

这些工具提供的健康检查算法与热门 CLI Henry 提供的相同。

health_pulse：检查 Looker 实例的运行状况。
health_analyze：分析 Looker 对象的使用情况。
health_vacuum：查找可能未使用的 LookML 元素。

LookML 制作工具

借助这些工具，调用方可以编写和修改 LookML 文件，还可以获取有效编写 LookML 所需的数据库架构。

dev_mode：为会话开启和关闭开发模式。LookML 编写必须在开发模式下完成。在开发模式下运行的查询会使用修改后的 LookML，因此您可以测试更改的影响。
get_projects：获取可用 LookML 项目的列表。
get_project_files：获取项目中的 LookML 文件列表。
get_project_file：获取 LookML 文件的内容。
create_project_file：创建新的 LookML 文件。
update_project_file：修改现有 LookML 文件。
delete_project_file：删除 LookML 文件。
get_connections：获取连接列表。
get_connection_schemas：获取连接的架构列表。
get_connection_databases：获取连接的数据库列表。
get_connection_tables：获取连接的表列表。
get_connection_table_columns：获取连接中表的列列表。