此页面由 Cloud Translation API 翻译。

使用 MCP Toolbox 将 IDE 连接到 Looker

本页面介绍了如何使用 MCP Toolbox for Databases 将 Looker 实例连接到支持 Model Context Protocol (MCP) 的集成开发环境 (IDE) 和开发者工具。您可以使用这些工具运行查询并与 Looker 互动。本指南适用于使用现有 IDE 和开发者工具来处理 Looker 的开发者。

MCP 是一种开放协议，用于将大语言模型 (LLM) 连接到 Looker 等数据源。本页介绍如何使用 MCP Toolbox for Databases 通过以下 IDE 将开发者辅助工具公开给 Looker 实例：

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

设置 Looker

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

安装 MCP Toolbox

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

linux/amd64

curl -O https://storage.googleapis.com/genai-toolbox/v0.12.0/linux/amd64/toolbox

darwin/arm64

curl -O https://storage.googleapis.com/genai-toolbox/v0.12.0/darwin/arm64/toolbox

darwin/amd64

curl -O https://storage.googleapis.com/genai-toolbox/v0.12.0/darwin/amd64/toolbox

windows/amd64

curl -O https://storage.googleapis.com/genai-toolbox/v0.12.0/windows/amd64/toolbox.exe

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

配置 MCP 客户端

Gemini CLI

安装 Gemini CLI。
在工作目录中，创建一个名为 .gemini 的文件夹。在该文件夹中，创建一个 settings.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 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：向信息中心添加图块。