MCP ツールボックスを使用して IDE を AlloyDB に接続する

このページでは、データベース向け MCP ツールボックスを使用して、AlloyDB for PostgreSQL インスタンスを Model Context Protocol（MCP）をサポートする統合開発環境（IDE）とデベロッパーツールに接続する方法について説明します。これらのツールを使用して、SQL クエリを実行し、データベースを操作します。このガイドは、既存の IDE とデベロッパーツールを使用して AlloyDB を操作するデベロッパーを対象としています。

このページでは、AlloyDB データベースがあり、AlloyDB インスタンスにパブリック IP アドレスがあることを前提としています。詳細については、MCP ツールボックスを使用して AlloyDB データベースを作成するをご覧ください。

Model Context Protocol（MCP）は、大規模言語モデル（LLM）を AlloyDB などのデータソースに接続するためのオープンプロトコルです。このページでは、データベース向け MCP ツールボックスを使用して、次の IDE を使用する AlloyDB インスタンスにデベロッパー支援ツールを公開する方法について説明します。

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

始める前に

必要なロールが付与されていることを確認してください。

必要なロール

AlloyDB インスタンスに接続するには、次のロールまたは同等の Identity and Access Management（IAM）権限が必要です。

Cloud AlloyDB クライアント（roles/alloydb.client）
Service Usage ユーザー（roles/serviceusage.serviceUsageConsumer）

データベースを設定する

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

AlloyDB for PostgreSQL の作成と接続に必要な Cloud APIs を有効にします。

API を有効にする
1. [プロジェクトを確認] の手順で、[次へ] をクリックして、変更するプロジェクトの名前を確認します。
2. [API を有効にする] の手順で、[有効にする] をクリックして、次の機能を有効にします。
  - AlloyDB API
  - Compute Engine API
  - Cloud Resource Manager API
  - Service Networking API
  AlloyDB と同じ Google Cloud プロジェクトにある VPC ネットワークを使用して AlloyDB へのネットワーク接続を構成する場合は、Service Networking API が必要です。
  
  別の Google Cloud プロジェクトに存在する VPC ネットワークを使用して AlloyDB へのネットワーク接続を構成する場合は、Compute Engine API と Cloud Resource Manager API が必要です。
クラスタとそのプライマリインスタンスを作成または選択します。MCP ツールボックスを AlloyDB 言語コネクタを使用してインスタンスに安全に接続します。
使用する環境のアプリケーションのデフォルト認証情報（ADC）を構成します。
データベースユーザーを作成または再利用します。ユーザー名とパスワードを入力できるよう準備します。

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

MCP ツールボックスの最新バージョンをバイナリとしてダウンロードします。オペレーティングシステム（OS）と CPU アーキテクチャに対応するバイナリを選択します。MCP ツールボックスのバージョン V0.7.0 以降を使用する必要があります。
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
バイナリを実行可能にします。
```
chmod +x toolbox
```
インストールを確認します。
```
./toolbox --version
```

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

Claude Code

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

{
  "mcpServers": {
    "alloydb": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","alloydb-postgres","--stdio"],
      "env": {
          "ALLOYDB_POSTGRES_PROJECT": "PROJECT_ID",
          "ALLOYDB_POSTGRES_REGION": "REGION",
          "ALLOYDB_POSTGRES_CLUSTER": "CLUSTER_NAME",
          "ALLOYDB_POSTGRES_INSTANCE": "INSTANCE_NAME",
          "ALLOYDB_POSTGRES_DATABASE": "DATABASE_NAME",
          "ALLOYDB_POSTGRES_USER": "USERNAME",
          "ALLOYDB_POSTGRES_PASSWORD": "PASSWORD"
      }
    }
  }
}

Claude Desktop

Claude Desktop を開き、[Settings] に移動します。
[Developer] タブで [Edit Config] をクリックして、構成ファイルを開きます。
構成を追加し、環境変数を実際の値に置き換えて保存します。

{
  "mcpServers": {
    "alloydb": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","alloydb-postgres","--stdio"],
      "env": {
          "ALLOYDB_POSTGRES_PROJECT": "PROJECT_ID",
          "ALLOYDB_POSTGRES_REGION": "REGION",
          "ALLOYDB_POSTGRES_CLUSTER": "CLUSTER_NAME",
          "ALLOYDB_POSTGRES_INSTANCE": "INSTANCE_NAME",
          "ALLOYDB_POSTGRES_DATABASE": "DATABASE_NAME",
          "ALLOYDB_POSTGRES_USER": "USERNAME",
          "ALLOYDB_POSTGRES_PASSWORD": "PASSWORD"
      }
    }
  }
}

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

Cline

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

{
  "mcpServers": {
    "alloydb": {
     "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","alloydb-postgres","--stdio"],
      "env": {
          "ALLOYDB_POSTGRES_PROJECT": "PROJECT_ID",
          "ALLOYDB_POSTGRES_REGION": "REGION",
          "ALLOYDB_POSTGRES_CLUSTER": "CLUSTER_NAME",
          "ALLOYDB_POSTGRES_INSTANCE": "INSTANCE_NAME",
          "ALLOYDB_POSTGRES_DATABASE": "DATABASE_NAME",
          "ALLOYDB_POSTGRES_USER": "USERNAME",
          "ALLOYDB_POSTGRES_PASSWORD": "PASSWORD"
      }
    }
  }
}

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

Cursor

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

{
  "mcpServers": {
    "alloydb": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","alloydb-postgres","--stdio"],
      "env": {
          "ALLOYDB_POSTGRES_PROJECT": "PROJECT_ID",
          "ALLOYDB_POSTGRES_REGION": "REGION",
          "ALLOYDB_POSTGRES_CLUSTER": "CLUSTER_NAME",
          "ALLOYDB_POSTGRES_INSTANCE": "INSTANCE_NAME",
          "ALLOYDB_POSTGRES_DATABASE": "DATABASE_NAME",
          "ALLOYDB_POSTGRES_USER": "USERNAME",
          "ALLOYDB_POSTGRES_PASSWORD": "PASSWORD"
      }
    }
  } 
}

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

Visual Studio Code（Copilot）

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

{
  "servers": {
    "alloydb": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","alloydb-postgres","--stdio"],
      "env": {
        "ALLOYDB_POSTGRES_PROJECT": "PROJECT_ID",
        "ALLOYDB_POSTGRES_REGION": "REGION",
        "ALLOYDB_POSTGRES_CLUSTER": "CLUSTER_NAME",
        "ALLOYDB_POSTGRES_INSTANCE": "INSTANCE_NAME",
        "ALLOYDB_POSTGRES_DATABASE": "DATABASE_NAME",
        "ALLOYDB_POSTGRES_USER": "USERNAME",
        "ALLOYDB_POSTGRES_PASSWORD": "PASSWORD"
      }
    }
  }
}

Windsurf

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

{
  "mcpServers": {
    "alloydb": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","alloydb-postgres","--stdio"],
      "env": {
          "ALLOYDB_POSTGRES_PROJECT": "PROJECT_ID",
          "ALLOYDB_POSTGRES_REGION": "REGION",
          "ALLOYDB_POSTGRES_CLUSTER": "CLUSTER_NAME",
          "ALLOYDB_POSTGRES_INSTANCE": "INSTANCE_NAME",
          "ALLOYDB_POSTGRES_DATABASE": "DATABASE_NAME",
          "ALLOYDB_POSTGRES_USER": "USERNAME",
          "ALLOYDB_POSTGRES_PASSWORD": "PASSWORD"
      }
    }
  }
}

Gemini CLI

Gemini CLI をインストールします。
作業ディレクトリに .gemini という名前のフォルダを作成します。その中に settings.json ファイルを作成します。
次の構成を追加し、環境変数を実際の値に置き換えて保存します。

{
  "mcpServers": {
    "alloydb": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","alloydb-postgres","--stdio"],
      "env": {
          "ALLOYDB_POSTGRES_PROJECT": "PROJECT_ID",
          "ALLOYDB_POSTGRES_REGION": "REGION",
          "ALLOYDB_POSTGRES_CLUSTER": "CLUSTER_NAME",
          "ALLOYDB_POSTGRES_INSTANCE": "INSTANCE_NAME",
          "ALLOYDB_POSTGRES_DATABASE": "DATABASE_NAME",
          "ALLOYDB_POSTGRES_USER": "USERNAME",
          "ALLOYDB_POSTGRES_PASSWORD": "PASSWORD"
      }
    }
  }
}

Gemini Code Assist

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

{
  "mcpServers": {
    "alloydb": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","alloydb-postgres","--stdio"],
      "env": {
          "ALLOYDB_POSTGRES_PROJECT": "PROJECT_ID",
          "ALLOYDB_POSTGRES_REGION": "REGION",
          "ALLOYDB_POSTGRES_CLUSTER": "CLUSTER_NAME",
          "ALLOYDB_POSTGRES_INSTANCE": "INSTANCE_NAME",
          "ALLOYDB_POSTGRES_DATABASE": "DATABASE_NAME",
          "ALLOYDB_POSTGRES_USER": "USERNAME",
          "ALLOYDB_POSTGRES_PASSWORD": "PASSWORD"
      }
    }
  }
}

AI ツールを使用する

これで MCP を使用して AI ツールが AlloyDB に接続されました。AI アシスタントにテーブルのリスト表示、テーブルの作成、その他の SQL ステートメントの定義と実行を依頼してみてください。

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

list_tables: テーブルと説明を一覧表示します。
execute_sql: 任意の SQL ステートメントを実行します。

MCP ツールボックスを使用して IDE を AlloyDB に接続する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

始める前に

必要なロール

データベースを設定する

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

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

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

Claude Code

Claude Desktop

Cline

Cursor

Visual Studio Code（Copilot）

Windsurf

Gemini CLI

Gemini Code Assist

AI ツールを使用する

MCP ツールボックスを使用して IDE を AlloyDB に接続する