Эта страница переведена с помощью Cloud Translation API.

Подключите Gemini CLI к Looker с помощью MCP Toolbox.

1. Before You Begin

Вам потребуется доступ к работающему экземпляру Looker. Вам также понадобятся идентификатор клиента API (client_id) и секретный ключ клиента (client_secret).

Предварительные требования

Have a running Looker instance
Have access to a Linux or macOS command line

Что вы узнаете

How to install Gemini CLI
How to install MCP Toolbox
Как подключить Gemini CLI к Looker с помощью MCP Toolbox

Что вам понадобится

URL-адрес API-сервера Looker. Обычно он совпадает с URL-адресом 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 в надежное место. Вам потребуется нажать на значок глаза рядом с секретом, чтобы увидеть и скопировать его.

You can close the Looker browser windows now.

3. Install Gemini CLI

Откройте приложение «Терминал», чтобы получить доступ к командной строке macOS или Linux.

Run the following command:

npm install -g @google/gemini-cli

Если по какой-либо причине это не сработает, обратитесь к https://github.com/google-gemini/gemini-cli?tab=readme-ov-file#-installation для получения информации о вариантах установки или помощи.

Now run Gemini CLI with this command:

gemini

Вам будет предложено войти в систему. Следуйте инструкциям, и всё будет готово.

4. Install MCP Toolbox

Create MCP Toolbox directory

В терминале создайте директорию mcp-toolbox . Затем перейдите в эту директорию:

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

Identify the system architecture

Выполните команду 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.

Download MCP Toolbox

Если у вас установлена операционная система Linux, выполните следующую команду для загрузки MCP Toolbox:

curl https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/linux/amd64/toolbox

Если у вас установлена macOS с процессором Apple, выполните следующую команду для загрузки MCP Toolbox:

curl https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/darwin/arm64/toolbox

Если у вас установлена macOS с процессором Intel, выполните следующую команду для загрузки MCP Toolbox:

curl https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/darwin/amd64/toolbox

Make MCP Toolbox executable

Чтобы сделать программу MCP Toolbox исполняемой, выполните следующую команду:

chmod +x toolbox

Get the full path to toolbox

Чтобы получить полный путь к файлу панели инструментов, выполните следующую команду:

echo $HOME/mcp-toolbox/toolbox

It will probably result in something like this:

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

Save the result somewhere convenient.

5. Configure Gemini CLI

Отредактируйте файл $HOME/.gemini/settings.json . Используйте предпочитаемый вами текстовый редактор. Если вы нечасто редактируете файлы в Linux или macOS, nano — хороший выбор.

Add the following stanza to the json file:

  "mcpServers": {
    "looker": {
      "command": "FULL_PATH_TO_TOOLBOX",
      "args": [
        "--stdio",
        "--prebuilt",
        "looker,looker-dev"
      ],
      "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, URL_OF_LOOKER_INSTANCE, CLIENT_ID и CLIENT_SECRET на те, которые вы сохранили на предыдущих шагах. Сохраните отредактированный файл.

6. Use MCP Toolbox with Gemini CLI

Запустите Gemini CLI, введя gemini в командной строке.

Чтобы получить список доступных инструментов, введите следующее в командной строке Gemini:

/mcp list looker

Your result should look something like this:

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 информацию о доступных данных. Попробуйте выполнить одно из следующих действий:

What models are available in looker?
What explores are available in MODEL_NAME ?
Какие показатели и параметры доступны в EXPLORE_NAME ?

Подставьте свои собственные значения для MODEL_NAME и EXPLORE_NAME .

Далее попробуйте составить несколько запросов на естественном языке, на которые можно ответить, используя данные из вашего экземпляра Looker: «Каков мой общий доход за 2025 год?», «Сколько виджетов я продал в 4 квартале?» и т. д.

7. More prompts to try

Вы также можете попробовать запустить сохраненные Look-модели и панели мониторинга, создать новые Look-модели и панели мониторинга, и даже отредактировать модели LookML.

Запустите сохраненный запрос, введя команду, например, "Запустить запрос 'Monthly Inventory'". Gemini должен найти запрос с именем 'Monthly Inventory', затем выполнить соответствующий запрос и предоставить результаты.
Запустите панель мониторинга, введя запрос, например, "Свести данные с панели мониторинга 'отслеживание клиентов'". Gemini должен найти панель мониторинга с именем 'отслеживание клиентов', выполнить запросы, связанные с каждым элементом, и предоставить сводную информацию.
Чтобы создать сохраненный образ, попробуйте ввести запрос типа: «Создайте образ для отслеживания ежемесячной выручки с разбивкой по категориям товаров. Отобразите данные в виде столбчатой диаграммы с накоплением».
Чтобы создать информационную панель, попробуйте ввести запрос, например: «Создайте мне информационную панель для отслеживания динамики продаж на 2026 год».

Если вы являетесь разработчиком LookML, вы можете модифицировать LookML с помощью Gemini. Поэкспериментируйте с такими подсказками:

Запросите у Gemini список проектов LookML, используя команду "Какие проекты LookML доступны?".
Запросите у Gemini список файлов проекта. Введите вопрос: «Какие файлы доступны в проекте PROJECT_NAME ?». Подставьте название своего проекта.
Предложите Gemini добавить меру. "Создайте меру для усреднения значения поля sales_price в представлении VIEW_NAME ." Подставьте собственное имя представления.
Чтобы получить список подключений, используйте запрос "Какие подключения доступны в Looker?".
Получите связанные схемы. "Какие схемы содержатся в CONNECTION_NAME ?" Подставьте собственное имя подключения.
Получите связанные таблицы. "Какие таблицы находятся в CONNECTION_NAME в схеме SCHEMA_NAME ?" Подставьте свои собственные имена подключения и схемы.
Получите список столбцов таблицы. "Какие столбцы содержатся в таблице TABLE_NAME ?" Подставьте имя своей таблицы.
Теперь попросите Gemini добавить столбец в представление LookML. "Создайте измерение для столбца COLUMN_NAME ." Подставьте собственное имя столбца.

Используйте пользовательский интерфейс Looker для тестирования изменений и, при необходимости, для их фиксации. Инструменты Gemini и MCP Toolbox не позволяют фиксировать изменения LookML и отправлять их в рабочую среду.