请尽快向 Looker 黑客马拉松 2025 [公共部门版]提交您的黑客作品！赢得真正的“最佳黑客”奖，并展示您的数据实力。如需了解详情，请参阅常见问题解答和官方规则。

此页面由 Cloud Translation API 翻译。

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

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

为了获得最强大、最集成的体验，我们建议您使用 Gemini CLI 的专用 Looker 扩展程序。使用 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 会自动加载 Looker 扩展程序（适用于 Gemini CLI 扩展程序）及其工具，您可以使用这些工具与 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 可使用以下工具：

get_models：列出 Looker 实例上的所有 LookML 模型。
get_explores：列出给定模型中的探索。
get_dimensions：列出指定探索中的维度。
get_measures：列出指定探索中的度量。
get_filters：列出指定探索中的过滤条件。
get_parameters：列出指定探索中的参数。
query：运行查询并返回数据。
query_sql：返回 Looker 为查询生成的 SQL。
query_url：返回指向 Looker 中查询的链接，以便进一步探索。
get_looks：返回与指定标题或说明匹配的已保存的 Look。
run_look：运行已保存的 Look 并返回数据。
make_look：在 Looker 中创建已保存的 Look 并返回网址。
get_dashboards：返回与指定标题或说明匹配的已保存信息中心。
make_dashboard：在 Looker 中创建已保存的信息中心并返回网址。
add_dashboard_element：向信息中心添加图块。