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，以及 Apple 處理器的 arm64 或 Intel 處理器的 x86_64 i386。
下載 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、URL_OF_LOOKER_INSTANCE、CLIENT_ID 和 CLIENT_SECRET 替換為您在先前步驟中儲存的資訊。儲存編輯過的檔案。
6. 搭配 Gemini CLI 使用 MCP Toolbox
在指令列輸入 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 詢問可用資料。請嘗試下列任一做法：
- Looker 提供哪些模型？
- MODEL_NAME 提供哪些探索？
- 「EXPLORE_NAME」提供哪些指標和維度？
將 MODEL_NAME 和 EXPLORE_NAME 替換為您自己的值。
接著，請嘗試提出一些自然語言查詢，這些查詢可由 Looker 執行個體中的資料回答：「2025 年的總收益是多少？」「我在第 4 季賣出多少個小工具？」等。
7. 更多建議提示詞
您也可以嘗試執行已儲存的 Look 和資訊主頁、建立 Look 和資訊主頁，甚至是編輯 LookML 模型。
- 輸入提示 (例如「執行『每月庫存』Look 圖表」)，即可執行已儲存的 Look 圖表。Gemini 應搜尋名為「Monthly Inventory」的檢視畫面，然後執行相關查詢並分享結果。
- 輸入「彙整『顧客追蹤』資訊主頁」等提示，即可執行資訊主頁。Gemini 應搜尋名為「customer tracking」的資訊主頁，執行與每個圖塊相關聯的查詢，然後提供摘要。
- 如要建立已儲存的 Look 圖表，請嘗試使用「建立 Look 圖表，追蹤我每月按產品類別細分的收益。以堆疊柱狀圖顯示資料。
- 如要建立資訊主頁，請輸入「為我建立 2026 年的銷售脈動資訊主頁」等提示。
如果您是 LookML 開發人員，可以使用 Gemini 修改 LookML。嘗試使用下列提示詞：
- 提示 Gemini「有哪些可用的 LookML 專案？」，取得 LookML 專案清單。
- 提示 Gemini 擷取專案檔案清單。「專案 PROJECT_NAME 中有哪些檔案？」請代入您自己的專案名稱。
- 提示 Gemini 新增測量指標。「Create a measure to average the sales_price field in view VIEW_NAME 中 sales_price 欄位的平均值)。請代入您自己的檢視名稱。
- 擷取連線清單：「Looker 中有哪些連線可用？」
- 取得相關聯的結構定義。「CONNECTION_NAME 中有哪些結構定義？」請代入自己的連線名稱。
- 取得相關聯的資料表。「結構定義 SCHEMA_NAME 中 CONNECTION_NAME 有哪些資料表？」請代入您自己的連線和結構定義名稱。
- 取得資料表的欄。「TABLE_NAME 中有哪些資料欄？」請代入您自己的資料表名稱。
- 現在問問 Gemini 在 LookML 檢視中新增資料欄。「為資料欄 COLUMN_NAME 建立維度。」請代入您自己的資料欄名稱。
使用 Looker UI 測試變更，並視需要提交變更。Gemini 和 MCP 工具箱無法修訂 LookML 變更，並將其推送至正式環境。