MCP、Gemini CLI、その他のエージェントで Cloud SQL for SQL Server を使用する

MySQL   |  PostgreSQL   |  SQL Server

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

• Cloud SQL for SQL Server 用 Gemini CLI 拡張機能
• SQL Server 用 Gemini CLI 拡張機能

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

統合型のエクスペリエンスを実現するには、専用の Cloud SQL for SQL Server 用 Gemini CLI 拡張機能を使用することをおすすめします。

Google Cloudの次世代コマンドライン インターフェースである Gemini CLI は、基盤となる MCP サーバーを拡張機能に直接バンドルしているため、設定と構成が簡素化されます。Gemini CLI を使用するように Gemini Code Assist を構成すると、IDE でも同様の設定上のメリットを得られます。

Model Context Protocol（MCP）をサポートする他のデベロッパー ツールの場合は、MCP Toolbox for Databases（Toolbox）を手動で構成して接続できます。Toolbox は、認証や接続プーリングなどのタスクを管理して、AI エージェントをデータに接続するオープンソースの MCP サーバーです。これにより、IDE から自然言語を使用してデータを直接操作できます。これらのツールでは、この方法がデータベース操作のコア機能となります。

詳細については、事前構築済みツールと GitHub の MCP Toolbox for Databases をご覧ください。

Gemini CLI と拡張機能について

Gemini CLI は、開発ワークフローを効率化するように設計されたオープンソースの AI エージェントであり、コーディング、デバッグ、データ探索、コンテンツ作成を支援します。データベース サービスや分析サービス、一般的なオープンソース データベースを操作するためのエージェント インターフェースを提供します。

拡張機能の仕組み

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

Cloud SQL for SQL Server で Gemini CLI 拡張機能を使用する

Cloud SQL Gemini CLI 拡張機能は、MCP Toolbox for Databases を基盤としています。MCP Toolbox for Databases は現在ベータ版（v1.0 より前）であり、最初の安定版リリース（v1.0）まで互換性を破る変更が行われる可能性があります。

Gemini CLI との統合は、標準の Toolbox 接続と比べて追加の機能を提供する専用の拡張機能を通じて行われます。この拡張機能は、効率的なインストール プロセスと一連のツールを提供します。

詳細については、Cloud SQL for SQL Server 用 Gemini CLI 拡張機能の GitHub ドキュメントをご覧ください。

Cloud SQL for SQL Server データベース用の Gemini CLI 拡張機能

cloud-sql-sqlserver 拡張機能には、データベースのクエリとデータベースの健全性のモニタリングを行うためのツールが含まれています。

カテゴリ	ツール
データベース オペレーション	list_tables: データベース内のすべてのテーブルと対応する説明を一覧表示します。 execute_sql: 任意の SQL ステートメントを実行します。
インスタンスとユーザーのリソース管理	create_user: Cloud SQL インスタンスに新しいユーザーを作成します。 list_user: 特定のプロジェクトの Cloud SQL ユーザーを一覧表示します。 list_instances: 特定のプロジェクトの Cloud SQL インスタンスを一覧表示します。 get_instance: 特定の Cloud SQL インスタンスの詳細を取得します。 get_user: 特定の Cloud SQL ユーザーの詳細を取得します。 create_instance: 新しい Cloud SQL インスタンスを作成します。 wait_for_operation: オペレーションが完了するまでオペレーション API をポーリングします。

cloud-sql-sqlserver-observability 拡張機能は、Gemini CLI から直接データベースのパフォーマンスと健全性を管理およびモニタリングするための統合インターフェースを提供します。

カテゴリ	ツール
オブザーバビリティ	get_system_metrics: Cloud SQL インスタンスのシステム指標を取得します。

SQL Server データベース用の Gemini CLI 拡張機能

これらのオペレーションの一覧については、MCP Toolbox for Databases と SQL Server 用 Gemini CLI 拡張機能をご覧ください。

始める前に

• Google Cloud コンソールのプロジェクト選択ページで、 Google Cloud プロジェクトを選択または作成します。

• Google Cloud プロジェクトに対して課金が有効になっていることを確認します。

• Google Cloud プロジェクトで Cloud SQL Admin API を有効にします。

• Cloud SQL は、新しいインスタンスにデフォルトでパブリック IP アドレスを割り当てます。ユースケースに応じて、Cloud SQL インスタンスにパブリック IP またはプライベート IP のいずれかが設定されていることを確認します。Toolbox は、Cloud SQL 言語コネクタを使用して安全に接続します。

• MCP サーバーを実行するユーザーに必要な Identity and Access Management（IAM）ロールを付与します。使用できるツールは、付与されたロールによって異なります。

  タスク	ロール名	必要な IAM ロール
  次のオペレーションを含む、リソースに対する読み取り専用アクセス権を付与します。 get_instance list_instances list_databases wait_for_operation	Cloud SQL 閲覧者	roles/cloudsql.viewer
  時系列指標などのモニタリング データに対する読み取り専用アクセス権を付与します。	Cloud Monitoring 閲覧者	roles/monitoring.viewer
  次のものを含む、既存のリソースを管理する権限を付与します。 すべての viewer ツール create_database	Cloud SQL 編集者	roles/cloudsql.editor
  次のものを含む、すべてのリソースに対する完全な制御権限を付与します。 すべての viewer ツールと editor ツール create_instance create_user	Cloud SQL 管理者	roles/cloudsql.admin

• 使用する環境のアプリケーションのデフォルト認証情報（ADC）を構成します。

• データベース ユーザーを作成または再利用し、ユーザー名とパスワードを用意します。

MCP Toolbox をインストールする

注: この手順は、Gemini CLI 拡張機能では必要ありません。

1. Toolbox をインストールするには、オペレーティング システムと CPU アーキテクチャに対応するバイナリをダウンロードします。

   linux/amd64

   curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/linux/amd64/toolbox

   darwin/arm64

   curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/darwin/arm64/toolbox

   darwin/amd64

   curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/darwin/amd64/toolbox

   windows/amd64

   curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/windows/amd64/toolbox

2. バイナリを実行可能にします。

   chmod +x toolbox
   

3. 次のコマンドを使用して、インストールを確認します。

   ./toolbox --version
   

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

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

Cloud SQL for SQL Server 用 Gemini CLI

1. Gemini CLI をインストールします。
2. 次のコマンドを使用して、GitHub リポジトリから Gemini CLI 用 Cloud SQL for SQL Server 拡張機能をインストールします。

      gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-sqlserver
      

3. Cloud SQL インスタンスに接続するための環境変数を設定します。

      export CLOUD_SQL_MSSQL_PROJECT="PROJECT_NAME"
      export CLOUD_SQL_MSSQL_REGION="REGION"
      export CLOUD_SQL_MSSQL_INSTANCE="INSTANCE_NAME"
      export CLOUD_SQL_MSSQL_DATABASE="DATABASE_NAME"
      export CLOUD_SQL_MSSQL_USER="DATABASE_USER_NAME"
      export CLOUD_SQL_MSSQL_PASSWORD="PASSWORD"
      export CLOUD_SQL_MSSQL_IP_TYPE="IP_TYPE"
      

次のように置き換えます。

• PROJECT_NAME: Google Cloud プロジェクト ID
• REGION: Cloud SQL インスタンスのリージョン。
• INSTANCE_NAME: Cloud SQL インスタンスの ID。
• DATABASE_NAME: 接続先のデータベースの名前。
• DATABASE_USER_NAME: 省略可: データベースのユーザー名。指定しない場合のデフォルトは IAM 認証です。
• PASSWORD: 省略可: データベース ユーザーのパスワード。指定しない場合のデフォルトは IAM 認証です。
• IP_TYPE: 省略可: IP タイプ（「Public」（デフォルト）、「Private」など）。

4. インタラクティブ モードで Gemini CLI を起動します。

      gemini
      

CLI は、Cloud SQL 用 Gemini CLI 拡張機能とそのツールを自動的に読み込みます。これらのツールを使用して、データベースを操作できます。

Gemini CLI で、/extensions コマンドを使用して拡張機能がインストールされていることを確認し、/mcp list コマンドを使用してツールを表示します。

SQL Server 用 Gemini CLI

1. Gemini CLI をインストールします。
2. 次のコマンドを使用して、GitHub リポジトリから Gemini CLI 用 SQL Server ソフトウェア拡張機能をインストールします。

      gemini extensions install https://github.com/gemini-cli-extensions/sql-server
      

3. SQL Server インスタンスに接続するための環境変数を設定します。

      export MSSQL_HOST="HOST"
      export MSSQL_PORT="PORT"
      export MSSQL_DATABASE="DATABASE"
      export MSSQL_USER="USER"
      export MSSQL_PASSWORD="PASSWORD"
      

次のように置き換えます。

• HOST: SQL Server サーバーのホスト名または IP アドレス。
• PORT: SQL Server サーバーのポート番号。
• DATABASE: 接続先のデータベースの名前。
• USER: データベースのユーザー名。
• PASSWORD: データベース ユーザーのパスワード。

4. インタラクティブ モードで Gemini CLI を起動します。

      gemini
      

CLI は、SQL Server 用 Gemini CLI 拡張機能とそのツールを自動的に読み込みます。これらのツールを使用して、データベースを操作できます。

Gemini Code Assist

1. Visual Studio Code に Gemini Code Assist 拡張機能をインストールします。
2. Gemini Code Assist のチャットでエージェント モードを有効にします。
3. 作業ディレクトリに .gemini という名前のフォルダを作成します。その中に settings.json ファイルを作成します。
4. 次の構成を追加し、環境変数を実際の値に置き換えて保存します。

{
  "mcpServers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

Claude Code

1. Claude Code をインストールします。
2. .mcp.json ファイルが存在しない場合は、プロジェクトのルートに作成します。
3. 構成を追加し、環境変数を実際の値に置き換えて保存します。

{
  "mcpServers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

Claude Desktop

1. Claude Desktop を開き、[設定] に移動します。
2. [開発者] タブで [構成を編集] をタップして、構成ファイルを開きます。
3. 構成を追加し、環境変数を実際の値に置き換えて保存します。

{
  "mcpServers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

5. Claude Desktop を再起動します。
6. 新しいチャット画面に、使用可能な新しい MCP サーバーのハンマー（MCP）アイコンが表示されます。

Cline

1. VS Code で Cline 拡張機能を開き、[MCP Servers] アイコンをタップします。
2. [Configure MCP Servers] をタップして構成ファイルを開きます。
3. 次の構成を追加し、環境変数を実際の値に置き換えて保存します。

{
  "mcpServers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

4. サーバーが正常に接続されると、緑色のアクティブ ステータスが表示されます。

Cursor

1. プロジェクトのルートに .cursor ディレクトリが存在しない場合は作成します。
2. .cursor/mcp.json ファイルが存在しない場合は作成して開きます。
3. 次の構成を追加し、環境変数を実際の値に置き換えて保存します。

{
  "mcpServers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

4. Cursor を開き、[Settings] > [Cursor Settings] > [MCP] に移動します。サーバーが接続されると、緑色のアクティブ ステータスが表示されます。

Visual Studio Code（Copilot）

1. VS Code を開き、プロジェクトのルートに .vscode ディレクトリが存在しない場合は作成します。
2. .vscode/mcp.json ファイルが存在しない場合は作成して開きます。
3. 次の構成を追加し、環境変数を実際の値に置き換えて保存します。

{
  "servers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

Windsurf

1. Windsurf を開き、Cascade アシスタントに移動します。
2. MCP アイコンをタップし、[Configure] をタップして構成ファイルを開きます。
3. 次の構成を追加し、環境変数を実際の値に置き換えて保存します。

{
  "mcpServers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}