使用 MCP Toolbox 将 Gemini CLI 连接到 Looker

1. 准备工作

您应有权访问正在运行的 Looker 实例。您需要 API client_id 和 client_secret。

前提条件

  • 拥有正在运行的 Looker 实例
  • 能够访问 Linux 或 macOS 命令行

学习内容

  • 如何安装 Gemini CLI
  • 如何安装 MCP Toolbox
  • 如何使用 MCP Toolbox 将 Gemini CLI 连接到 Looker

所需条件

  • Looker API 服务器的网址。这通常与 Looker 网址相同，但您可能需要附加一个端口号（例如 :19999），例如：https://looker.example.com:19999。如果一切正常，请尝试咨询 Looker 管理员。

2. 准备工作

您需要检索 client_id 和 client_secret。

登录 Looker 实例，然后点击屏幕右上角的用户个人资料。选择账号。在“账号”界面上，按 API Keys 标签旁边的 Manage 按钮。

在 API 密钥管理页面上，按 Create New API Key 按钮。

在新创建的条目中，添加用途 MCP Toolbox 或类似内容，然后点击对勾标记以保存。然后，将 client_id 和 client_secret 复制并粘贴到安全的位置。您需要按密钥旁边的眼睛图标才能查看和复制密钥。

您现在可以关闭 Looker 浏览器窗口了。

3. 安装 Gemini CLI

打开终端应用，进入 macOS 或 Linux 命令行。

运行以下命令：

npm install -g @google/gemini-cli

如果因任何原因而失败，请参阅 https://github.com/google-gemini/gemini-cli?tab=readme-ov-file#-installation，了解安装选项或寻求帮助。

现在，运行以下命令来运行 Gemini CLI：

gemini

系统会要求您登录。按照这些说明操作，您应该就可以开始使用了。

4. 安装 MCP Toolbox

创建 MCP Toolbox 目录

在终端应用中，创建一个目录 mcp-toolbox。然后进入该目录：

mkdir $HOME/mcp-toolbox
cd $HOME/mcp-toolbox

确定系统架构

运行 uname 命令，了解您使用的是哪种系统：

uname -a

此命令将返回一个类似于以下内容的字符串：

Linux hostname.example.com 6.16.12-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.16.12 (2025-11-10) x86_64 GNU/Linux

请密切注意该行的末尾。如果您使用的是 Linux，则会以 x86_64 GNU/Linux 结尾。对于 macOS，该字符串末尾附近会显示 Darwin，以及 arm64（表示 Apple 处理器）或 x86_64 i386（表示 Intel 处理器）。

下载 MCP Toolbox

如果您使用的是 Linux，请运行以下命令来下载 MCP Toolbox：

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

如果您使用的是搭载 Apple 处理器的 macOS，请运行以下命令下载 MCP Toolbox：

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

如果您使用的是配备 Intel 处理器的 macOS，请运行以下命令来下载 MCP Toolbox：

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

使 MCP Toolbox 可执行

运行以下命令，使 MCP Toolbox 程序可执行：

chmod +x toolbox

获取工具箱的完整路径

运行以下命令，获取工具箱文件的完整路径：

echo $HOME/mcp-toolbox/toolbox

这可能会产生如下结果：

/home-or-User/YOUR-USER-NAME/mcp-toolbox/toolbox

将结果保存在方便访问的位置。

5. 配置 Gemini CLI

修改文件 $HOME/.gemini/settings.json。使用您偏好的文本编辑器。如果您不经常在 Linux 或 macOS 中编辑文件，可以选择使用 nano。

将以下节添加到 JSON 文件中：

  "mcpServers": {
    "looker": {
      "command": "FULL_PATH_TO_TOOLBOX",
      "args": [
        "--stdio",
        "--prebuilt",
        "looker"
      ],
      "env": {
        "LOOKER_BASE_URL": "URL_OF_LOOKER_INSTANCE",
        "LOOKER_CLIENT_ID": "CLIENT_ID",
        "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
        "LOOKER_VERIFY_SSL": "true"
      }
    }
  }

将 FULL_PATH_TO_TOOLBOX、网址_OF_LOOKER_INSTANCE、CLIENT_ID 和 CLIENT_SECRET 替换为您在之前的步骤中保存的信息。保存修改后的文件。

6. 将 MCP 工具箱与 Gemini CLI 搭配使用

在命令行中输入 gemini，启动 Gemini CLI。

在 Gemini 提示中输入以下内容，列出可用的工具：

/mcp list looker

结果应如下所示：

Configured MCP servers:

🟢 looker - Ready (33 tools)
  Tools:
  - add_dashboard_element
  - add_dashboard_filter
  - create_project_file
  - delete_project_file
  - dev_mode
  - generate_embed_url
  - get_connection_databases
  - get_connection_schemas
  - get_connection_table_columns
  - get_connection_tables
  - get_connections
  - get_dashboards
  - get_dimensions
  - get_explores
  - get_filters
  - get_looks
  - get_measures
  - get_models
  - get_parameters
  - get_project_file
  - get_project_files
  - get_projects
  - health_analyze
  - health_pulse
  - health_vacuum
  - make_dashboard
  - make_look
  - query
  - query_sql
  - query_url
  - run_dashboard
  - run_look
  - update_project_file

现在，开始向 Gemini CLI 询问有关可用数据的问题。您可以尝试以下操作：

  1. Looker 中有哪些模型？
  2. MODEL_NAME 中有哪些探索？
  3. EXPLORE_NAME中提供了哪些指标和维度？

将 MODEL_NAME 和 EXPLORE_NAME 替换为您自己的值。

接下来，尝试提出一些自然语言查询，这些查询可以通过 Looker 实例中的数据来回答：“2025 年的总收入是多少？”“我第四季度的 widget 销量是多少？”等。

7. 更多可尝试的提示

您还可以尝试运行已保存的 Look 和信息中心、创建 Look 和信息中心，甚至编辑 LookML 模型。

  • 输入“运行 Look‘月度广告资源’”等提示，运行已保存的 Look。Gemini 应该搜索名为“Monthly Inventory”（月度库存）的 Look，然后运行关联的查询并分享结果。
  • 通过提供“总结‘客户跟踪’信息中心”之类的提示来运行信息中心。Gemini 应搜索名为“客户跟踪”的信息中心，运行与每个图块相关联的查询，并提供摘要。
  • 如需创建已保存的 Look，请尝试使用以下提示：“创建一个 Look，用于按商品类别细分我的月度收入。以堆叠柱形图的形式显示数据。
  • 如需创建信息中心，请尝试输入“为我构建 2026 年的销售脉搏信息中心”之类的提示。

如果您是 LookML 开发者，则可以使用 Gemini 修改 LookML。尝试使用以下提示：

  1. 提示 Gemini 获取 LookML 项目列表，例如“有哪些可用的 LookML 项目？”
  2. 提示 Gemini 检索项目文件列表。“项目 PROJECT_NAME 中有哪些文件？”替换为您自己的项目名称。
  3. 提示 Gemini 添加衡量指标。“创建一个测量，用于计算视图 VIEW_NAME 中 sales_price 字段的平均值。”替换为您自己的视图名称。
  4. 如需检索连接列表，请参阅“Looker 中有哪些连接？”
  5. 获取关联的架构。“CONNECTION_NAME 中有哪些架构？”替换为您自己的连接名称。
  6. 获取关联的表格。“CONNECTION_NAME 中架构 SCHEMA_NAME 内有哪些表？”替换为您自己的连接和架构名称。
  7. 获取表的列。“TABLE_NAME 中有哪些列？”替换为您自己的表名。
  8. 现在，问问 Gemini 向 LookML 视图添加列。“为列 COLUMN_NAME 创建维度。”替换为您自己的列名称。

使用 Looker 界面测试更改，并根据需要提交更改。Gemini 和 MCP Toolbox 无法提交 LookML 更改并将其推送到生产环境。

8. 其他信息