本頁面由 Cloud Translation API 翻譯而成。

使用 MCP Toolbox 將 IDE 連線至 Looker

本頁說明如何使用 MCP Toolbox for databases，將 Looker 執行個體連線至支援模型上下文協定 (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 電腦版
Claude 程式碼

設定 Looker

取得 Looker 用戶端 ID 和用戶端密鑰。按照「Looker API 驗證」說明文件頁面的指示操作。
請準備好 Looker 執行個體的基本網址。可能類似 https://looker.example.com。在某些情況下，API 會監聽不同的通訊埠，因此您需要改用 https://looker.example.com:19999。

安裝 MCP Toolbox

以二進位檔形式下載最新版 MCP Toolbox。選取與 OS 和 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：視您是否使用 SSL 加密將資料庫連線至 Looker 執行個體而定，可能是 true 或 false。

{
  "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 代碼

安裝 Claude Code。
如果專案根目錄中沒有 .mcp.json 檔案，請建立該檔案。
新增下列設定，將下列環境變數替換成您的值，然後儲存。
- LOOKER_URL：Looker 執行個體的網址。
- CLIENT_ID 和 CLIENT_SECRET：用來存取 Looker API 的 API 金鑰。
- VERIFY_SSL：視您是否使用 SSL 加密將資料庫連線至 Looker 執行個體而定，可能是 true 或 false。

{
  "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 電腦版

開啟 Claude Desktop，然後前往「設定」。
在「開發人員」分頁中，按一下「編輯設定」開啟設定檔。
新增下列設定，將下列環境變數替換成您的值，然後儲存。
- LOOKER_URL：Looker 執行個體的網址。
- CLIENT_ID 和 CLIENT_SECRET：用來存取 Looker API 的 API 金鑰。
- VERIFY_SSL：視您是否使用 SSL 加密將資料庫連線至 Looker 執行個體而定，可能是 true 或 false。

{
  "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 Servers」(MCP 伺服器) 圖示。
按一下「設定 MCP 伺服器」開啟設定檔。
新增下列設定，將下列環境變數替換成您的值，然後儲存。
- LOOKER_URL：Looker 執行個體的網址。
- CLIENT_ID 和 CLIENT_SECRET：用來存取 Looker API 的 API 金鑰。
- VERIFY_SSL：視您是否使用 SSL 加密將資料庫連線至 Looker 執行個體而定，可能是 true 或 false。

{
  "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 目錄 (如果不存在)。
如果 .cursor/mcp.json 檔案不存在，請建立並開啟該檔案。
新增下列設定，將下列環境變數替換成您的值，然後儲存。
- LOOKER_URL：Looker 執行個體的網址。
- CLIENT_ID 和 CLIENT_SECRET：用來存取 Looker API 的 API 金鑰。
- VERIFY_SSL：視您是否使用 SSL 加密將資料庫連線至 Looker 執行個體而定，可能是 true 或 false。

{
  "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",
     }
    }
  }
}

開啟「游標」，然後依序前往「設定」>「游標設定」>「MCP」。伺服器連線後，會顯示綠色的「有效」狀態。

Visual Studio Code (Copilot)

開啟 VS Code，並在專案根目錄中建立 .vscode 目錄 (如果不存在)。
如果 .vscode/mcp.json 檔案不存在，請建立並開啟該檔案。
新增下列設定，將下列環境變數替換成您的值，然後儲存。
- LOOKER_URL：Looker 執行個體的網址。
- CLIENT_ID 和 CLIENT_SECRET：用來存取 Looker API 的 API 金鑰。
- VERIFY_SSL：視您是否使用 SSL 加密將資料庫連線至 Looker 執行個體而定，可能是 true 或 false。

{
  "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，然後前往 Cascade 助理。
按一下 MCP 圖示，然後點選「設定」開啟設定檔。
新增下列設定，將下列環境變數替換成您的值，然後儲存。
- LOOKER_URL：Looker 執行個體的網址。
- CLIENT_ID 和 CLIENT_SECRET：用來存取 Looker API 的 API 金鑰。
- VERIFY_SSL：視您是否使用 SSL 加密將資料庫連線至 Looker 執行個體而定，可能是 true 或 false。

{
  "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：傳回符合標題或說明的已儲存外觀。
run_look：執行已儲存的 Look 並傳回資料。
make_look：在 Looker 中建立已儲存的 Look，並傳回網址。
get_dashboards：傳回符合標題或說明的已儲存資訊主頁。
make_dashboard：在 Looker 中建立已儲存的資訊主頁，並傳回網址。
add_dashboard_element：將動態磚新增至資訊主頁。