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 ツールボックスの最新バージョンをバイナリとしてダウンロードします。OS と 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 を起動します。
CLI は、Gemini CLI 拡張機能の Looker 拡張機能とそのツールを自動的に読み込みます。これらのツールを使用して、Looker インスタンスを操作できます。gemini
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 を使用できます。
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 のクエリへのリンクを返して、さらに詳しく調べます。get_looks: タイトルまたは説明に一致する保存済みのルックを返します。run_look: 保存した Look を実行してデータを返します。make_look: Looker で保存済みの Look を作成し、URL を返します。get_dashboards: タイトルまたは説明に一致する保存済みダッシュボードを返します。make_dashboard: Looker で保存済みダッシュボードを作成し、URL を返します。add_dashboard_element: ダッシュボードにタイルを追加します。