このページは Cloud Translation API によって翻訳されました。

Looker を MCP、Gemini CLI、その他のエージェントで使用する

このページでは、Looker インスタンスをさまざまなデベロッパーツールに接続する方法について説明します。

最も強力で統合されたエクスペリエンスを実現するには、Gemini CLI 用の専用の Looker 拡張機能を使用することをおすすめします。Looker のセマンティックレイヤを使用して、Gemini CLI に信頼できるデータへの安全で管理されたオンデマンドアクセスを提供し、自然言語プロンプトからレポート、可視化、ダッシュボードの作成を自動化してワークフローを加速します。Google Cloud の次世代コマンドラインインターフェースである Gemini CLI は、コマンドラインから Looker インスタンスを操作する場合におすすめのツールです。

汎用のデータベース向け MCP ツールボックスを使用して、Model Context Protocol（MCP）をサポートする他の統合開発環境（IDE）やデベロッパーツールを接続することもできます。MCP ツールボックスは、認証や接続プーリングなどの複雑な処理を処理することで、AI エージェントをデータに簡単に接続できるようにするオープンソースの MCP サーバーです。これにより、IDE から自然言語を使用してデータを直接操作できます。これらのツールでは、このメソッドはコアとなるデータベース操作機能を提供します。

Gemini CLI と拡張機能について

Gemini CLI は、コーディング、デバッグ、データ探索、コンテンツ作成を支援することで、開発ワークフローを加速するように設計されたオープンソースの AI エージェントです。データクラウドサービスや一般的なオープンソースデータベースを操作できるエレガントなエージェントエクスペリエンスを提供することを目的としています。

拡張機能の仕組み

Gemini CLI は拡張性が高く、拡張機能を通じて新しいツールや機能を追加できます。これらの拡張機能は簡単にインストールできます。これらは、GitHub URL、ローカルディレクトリ、構成可能なレジストリから読み込むことができます。これらの拡張機能は、ワークフローを効率化するための新しいツール、スラッシュコマンド、プロンプトなど、豊富な機能を提供します。

Looker の設定

Looker のクライアント ID とクライアントシークレットを取得します。Looker API の認証のドキュメントページに記載されている手順に沿って操作します。
Looker インスタンスのベース URL を用意します。https://looker.example.com のような形式になります。API が別のポートでリッスンしている場合は、代わりに https://looker.example.com:19999 を使用する必要があります。

MCP ツールボックスをインストールする

MCP ツールボックスの最新バージョンをバイナリとしてダウンロードします。オペレーティングシステムと CPU アーキテクチャに対応するバイナリを選択します。MCP ツールボックスバージョン V0.14.0 以降を使用する必要があります。
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/v0.14.0/linux/amd64/toolbox
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/v0.14.0/darwin/arm64/toolbox
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/v0.14.0/darwin/amd64/toolbox
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/v0.14.0/windows/amd64/toolbox.exe
バイナリを実行可能にします。
```
chmod +x toolbox
```
インストールを確認します。
```
./toolbox --version
```

MCP クライアントを構成する

このセクションでは、データベース向け MCP ツールボックスを使用して Looker インスタンスに接続するように、さまざまなデベロッパーツールを構成する方法について説明します。このツールボックスは、IDE とデータベースの間に配置されるオープンソースの Model Context Protocol（MCP）サーバーとして機能し、AI ツール用の安全で効率的なコントロールプレーンを提供します。特定のツールのタブを選択して、構成手順を確認します。

Gemini CLI
Gemini Code Assist
Claude Code
Claude Desktop
Cline（VS Code 拡張機能）
Cursor
Visual Studio Code（Copilot）
Windsurf（Codium）

Gemini CLI

Gemini CLI をインストールします。
次のコマンドを使用して、GitHub リポジトリから Gemini CLI 用の Looker 拡張機能をインストールします。
```
gemini extensions install https://github.com/gemini-cli-extensions/looker
```
Looker インスタンスに接続するように環境変数を設定します。次の環境変数を実際の値に置き換えます。
- LOOKER_URL: Looker インスタンスの URL。
- CLIENT_ID と CLIENT_SECRET: Looker API へのアクセスに使用される API キー。
- VERIFY_SSL: データベースを Looker インスタンスに接続するために SSL 暗号化を使用するかどうかに応じて、true または false。
```
export LOOKER_BASE_URL="LOOKER_URL"
export LOOKER_CLIENT_ID="CLIENT_ID"
export LOOKER_CLIENT_SECRET="CLIENT_SECRET"
export LOOKER_VERIFY_SSL="VERIFY_SSL"
```
インタラクティブモードで Gemini CLI を起動します。
```
gemini
```
CLI は、Gemini CLI 拡張機能用の Looker 拡張機能とそのツールを自動的に読み込みます。これらのツールを使用して、Looker インスタンスを操作できます。

Gemini Code Assist

Gemini CLI を使用するように Gemini Code Assist を構成することをおすすめします。この方法では、MCP サーバーを手動で構成する必要がなくなります。

Gemini CLI と looker 拡張機能がインストールされ、構成されていることを確認します。
Gemini CLI を使用するように Gemini Code Assist を構成します。
Gemini Code Assist チャット内で自然言語を使用して Looker インスタンスとのやり取りを開始します。

Claude Code

Claude Code をインストールします。
プロジェクトのルートに .mcp.json ファイルが存在しない場合は作成します。
次の構成を追加し、次の環境変数を実際の値に置き換えて保存します。
- LOOKER_URL: Looker インスタンスの URL。
- CLIENT_ID と CLIENT_SECRET: Looker API へのアクセスに使用される API キー。
- VERIFY_SSL: データベースを Looker インスタンスに接続するために SSL 暗号化を使用するかどうかに応じて、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

Claude Desktop を開き、[Settings] に移動します。
[Developer] タブで [Edit Config] をクリックして、構成ファイルを開きます。
次の構成を追加し、次の環境変数を実際の値に置き換えて保存します。
- LOOKER_URL: Looker インスタンスの URL。
- CLIENT_ID と CLIENT_SECRET: Looker API へのアクセスに使用される API キー。
- VERIFY_SSL: データベースを Looker インスタンスに接続するために SSL 暗号化を使用するかどうかに応じて、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] アイコンをクリックします。
[Configure MCP Servers] をクリックして構成ファイルを開きます。
次の構成を追加し、次の環境変数を実際の値に置き換えて保存します。
- LOOKER_URL: Looker インスタンスの URL。
- CLIENT_ID と CLIENT_SECRET: Looker API へのアクセスに使用される API キー。
- VERIFY_SSL: データベースを Looker インスタンスに接続するために SSL 暗号化を使用するかどうかに応じて、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 インスタンスの URL。
- CLIENT_ID と CLIENT_SECRET: Looker API へのアクセスに使用される API キー。
- VERIFY_SSL: データベースを Looker インスタンスに接続するために SSL 暗号化を使用するかどうかに応じて、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 を開き、[Settings] > [Cursor Settings] > [MCP] に移動します。サーバーが接続されると、緑色のアクティブステータスが表示されます。

Visual Studio Code（Copilot）

VS Code を開き、プロジェクトのルートに .vscode ディレクトリが存在しない場合は作成します。
.vscode/mcp.json ファイルが存在しない場合は作成したうえで、それを開きます。
次の構成を追加し、次の環境変数を実際の値に置き換えて保存します。
- LOOKER_URL: Looker インスタンスの URL。
- CLIENT_ID と CLIENT_SECRET: Looker API へのアクセスに使用される API キー。
- VERIFY_SSL: データベースを Looker インスタンスに接続するために SSL 暗号化を使用するかどうかに応じて、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

Windsurf を開き、Cascade アシスタントに移動します。
MCP アイコンをクリックし、[Configure] をクリックして構成ファイルを開きます。
次の構成を追加し、次の環境変数を実際の値に置き換えて保存します。
- LOOKER_URL: Looker インスタンスの URL。
- CLIENT_ID と CLIENT_SECRET: Looker API へのアクセスに使用される API キー。
- VERIFY_SSL: データベースを Looker インスタンスに接続するために SSL 暗号化を使用するかどうかに応じて、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 アシスタントにモデル、Explore、ディメンション、メジャーのリスト表示を依頼してみてください。クエリの SQL を取得するか、保存した Look を実行して、クエリを実行することもできます。

次のツールで LLM を使用できます。

Looker のモデルツールとクエリツール

これらのツールは、Looker モデルに関する情報を取得し、そのモデルに対してクエリを実行するために使用されます。

get_models: Looker インスタンスのすべての LookML モデルを一覧表示します。
get_explores: 指定されたモデルの探索を一覧表示します。
get_dimensions: 指定された Explore のディメンションを一覧表示します。
get_measures: 指定された Explore の指標を一覧表示します。
get_filters: 指定された Explore のフィルタを一覧表示します。
get_parameters: 指定された Explore のパラメータを一覧表示します。
query: クエリを実行してデータを返します。
query_sql: クエリ用に Looker によって生成された SQL を返します。
query_url: Looker のクエリへのリンクを返して、さらに詳しく調べます。

Looker コンテンツツール

これらのツールは、Looker インスタンスから保存されたコンテンツ（Look とダッシュボード）を取得し、新しい保存済みコンテンツを作成します。

get_looks: タイトルまたは説明に一致する保存済みのルックを返します。
run_look: 保存した Look を実行してデータを返します。
make_look: Looker で保存済み Look を作成し、URL を返します。
get_dashboards: タイトルまたは説明に一致する保存済みダッシュボードを返します。
make_dashboard: Looker で保存済みダッシュボードを作成し、URL を返します。
add_dashboard_element: ダッシュボードにタイルを追加します。

Looker インスタンスのヘルスツール

これらのツールは、一般的な CLI Henry が提供するのと同じヘルスチェックアルゴリズムを提供します。

health_pulse: Looker インスタンスの健全性を確認します。
health_analyze: Looker オブジェクトの使用状況を分析します。
health_vacuum: 使用されていない可能性がある LookML 要素を検索します。

LookML 作成ツール

これらのツールを使用すると、呼び出し元は LookML ファイルの作成と変更を行うだけでなく、LookML を効果的に記述するために必要なデータベーススキーマを取得できます。

dev_mode: セッションの開発モードをオンまたはオフにします。LookML の作成は開発モードで行う必要があります。開発モードで実行されるクエリは、変更された LookML を使用するため、変更の影響をテストできます。
get_projects: 利用可能な LookML プロジェクトのリストを取得します。
get_project_files: プロジェクト内の LookML ファイルのリストを取得します。
get_project_file: LookML ファイルのコンテンツを取得します。
create_project_file: 新しい LookML ファイルを作成します。
update_project_file: 既存の LookML ファイルを変更します。
delete_project_file: LookML ファイルを削除します。
get_connections: 接続のリストを取得します。
get_connection_schemas: 接続のスキーマのリストを取得します。
get_connection_databases: 接続のデータベースのリストを取得します。
get_connection_tables: 接続のテーブルのリストを取得します。
get_connection_table_columns: 接続内のテーブルの列のリストを取得します。