このページでは、データベース向け MCP ツールボックスを使用して、統合開発環境（IDE）から AlloyDB for PostgreSQL クラスタとインスタンスを作成して管理する方法について説明します。Model Context Protocol（MCP）をサポートするデベロッパー ツールを使用できます。
Model Context Protocol（MCP）は、大規模言語モデル（LLM）を AlloyDB API などのデータソースや API に接続するためのオープン プロトコルです。AI アシスタントは、LLM を活用した IDE のチャット インターフェースで、目標の達成とタスクの完了を支援します。このページでは、データベース向け MCP ツールボックスと次の IDE を使用して、デベロッパー アシスタント ツールを AlloyDB インスタンスに公開する方法について説明します。
- Cursor
- Windsurf（Codium）
- Visual Studio Code（Copilot）
- Cline（VS Code 拡張機能）
- Claude Desktop
- Claude Code
- Gemini CLI
- Gemini Code Assist
始める前に
Google Cloud コンソールのプロジェクト セレクタページで、 Google Cloud プロジェクトを選択または作成します。
Google Cloud プロジェクトに対して課金が有効になっていることを確認します。詳しくは、プロジェクトで課金が有効になっているかどうかを確認する方法をご覧ください。
AlloyDB Admin API を有効にします。
必要なロール
AlloyDB リソースを管理するには、プロジェクトに対する次の Identity and Access Management ロールを付与するよう管理者に依頼してください。
- AlloyDB 管理者（
roles/alloydb.admin）。 - Service Usage ユーザー（
roles/serviceusage.serviceUsageConsumer）。
MCP ツールボックスをインストールする
MCP ツールボックスの最新バージョンをバイナリとしてダウンロードします。オペレーティング システム（OS）と CPU アーキテクチャに対応するバイナリを選択します。MCP ツールボックス バージョン V0.10.0 以降を使用する必要があります。
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/v0.10.0/linux/amd64/toolbox
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/v0.10.0/darwin/arm64/toolbox
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/v0.10.0/darwin/amd64/toolbox
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/v0.10.0/windows/amd64/toolbox
バイナリを実行可能にします。
chmod +x toolboxインストールを確認します。
./toolbox --version
MCP クライアントを構成する
コントロール プレーン ツールを使用して AlloyDB クラスタとインスタンスを作成および管理するように IDE を構成できます。AlloyDB インスタンスがすでに存在する場合は、この手順をスキップして、MCP Toolbox を使用して IDE を AlloyDB for PostgreSQL に接続するに進みます。インスタンスは、指定されたコントロール プレーン ツールを使用してパブリック IP アドレスで作成されます。IDE の MCP 設定ファイルに次の構成を追加します。この方法により、alloydb-postgres-admin ツールが AI アシスタントに公開されます。
Claude Code
- Claude Code をインストールします。
.mcp.jsonファイルが存在しない場合は、プロジェクトのルートに作成します。gcloud auth print-access-tokenを実行して、API_KEYとして使用するアクセス トークンを生成します。
- 次の構成を追加し、
API_KEYを生成されたトークンに置き換えて保存します。
{
"mcpServers": {
"alloydb-admin": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
"env": {
"API_KEY": "API_KEY"
}
}
}
}
Claude Desktop
- Claude Desktop を開き、[Settings] に移動します。
- [Developer] タブで [Edit Config] をクリックして、構成ファイルを開きます。
gcloud auth print-access-tokenを実行して、API_KEYとして使用するアクセス トークンを生成します。
- 次の構成を追加し、
API_KEYを生成されたトークンに置き換えて保存します。
{
"mcpServers": {
"alloydb-admin": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
"env": {
"API_KEY": "API_KEY"
}
}
}
}
Cline
- VS Code で Cline 拡張機能を開き、[MCP Servers] アイコンをタップします。
- [Configure MCP Servers] をタップして構成ファイルを開きます。
gcloud auth print-access-tokenを実行して、API_KEYとして使用するアクセス トークンを生成します。
- 次の構成を追加し、
API_KEYを生成されたトークンに置き換えて保存します。
{
"mcpServers": {
"alloydb-admin": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
"env": {
"API_KEY": "API_KEY"
}
}
}
}
Cursor
- プロジェクトのルートに
.cursorディレクトリが存在しない場合は作成します。 .cursor/mcp.jsonファイルが存在しない場合は作成し、開きます。gcloud auth print-access-tokenを実行して、API_KEYとして使用するアクセス トークンを生成します。
- 次の構成を追加し、
API_KEYを生成されたトークンに置き換えて保存します。
{
"mcpServers": {
"alloydb-admin": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
"env": {
"API_KEY": "API_KEY"
}
}
}
}
Visual Studio Code（Copilot）
- VS Code を開き、プロジェクトのルートに
.vscodeディレクトリが存在しない場合は作成します。 .vscode/mcp.jsonファイルが存在しない場合は作成し、開きます。gcloud auth print-access-tokenを実行して、API_KEYとして使用するアクセス トークンを生成します。
- 次の構成を追加し、
API_KEYを生成されたトークンに置き換えて保存します。
{
"servers": {
"alloydb-admin": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
"env": {
"API_KEY": "API_KEY"
}
}
}
}
Windsurf
- Windsurf を開き、Cascade アシスタントに移動します。
- MCP アイコンをクリックし、[Configure] をクリックして構成ファイルを開きます。
gcloud auth print-access-tokenを実行して、API_KEYとして使用するアクセス トークンを生成します。
- 次の構成を追加し、
API_KEYを生成されたトークンに置き換えて保存します。
{
"mcpServers": {
"alloydb-admin": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
"env": {
"API_KEY": "API_KEY"
}
}
}
}
Gemini CLI
- Gemini CLI をインストールします。
- 作業ディレクトリに
.geminiという名前のフォルダを作成します。その中にsettings.jsonファイルを作成します。 gcloud auth print-access-tokenを実行して、API_KEYとして使用するアクセス トークンを生成します。
- 次の構成を追加し、
API_KEYを生成されたトークンに置き換えて保存します。
{
"mcpServers": {
"alloydb-admin": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
"env": {
"API_KEY": "API_KEY"
}
}
}
}
Gemini Code Assist
- Visual Studio Code に Gemini Code Assist 拡張機能をインストールします。
- Gemini Code Assist のチャットでエージェント モードを有効にします。
- 作業ディレクトリに
.geminiという名前のフォルダを作成します。その中にsettings.jsonファイルを作成します。 gcloud auth print-access-tokenを実行して、API_KEYとして使用するアクセス トークンを生成します。
- 次の構成を追加し、
API_KEYを生成されたトークンに置き換えて保存します。
{
"mcpServers": {
"alloydb-admin": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
"env": {
"API_KEY": "API_KEY"
}
}
}
}
AI ツールが MCP を使用して AlloyDB for PostgreSQL コントロール プレーンに接続されました。AI アシスタントにクラスタまたはインスタンスの作成を依頼します。
管理者ツールを使用する
次のツールで LLM を使用できます。
- alloydb-create-cluster: AlloyDB クラスタを作成します。
- alloydb-create-instance: AlloyDB インスタンス（
PRIMARY、READ_POOL、SECONDARY）を作成します。 - alloydb-create-user: AlloyDB クラスタの
ALLOYDB_BUILT_INユーザーまたはIAMベースのユーザーを作成します。 - alloydb-get-operation: オペレーションが完了するまでオペレーション API をポーリングします。
- alloydb-list-clusters: 指定されたプロジェクトとロケーションのクラスタを一覧表示します。
- alloydb-list-instances: 指定されたプロジェクトとロケーションのインスタンスを一覧表示します。
- alloydb-list-users: 指定されたプロジェクトとロケーションのユーザーを一覧表示します。
データに接続する
AlloyDB クラスタとインスタンスを設定したら、IDE をデータベースに接続してデータをクエリできます。詳細については、MCP ツールボックスを使用して IDE を AlloyDB に接続するをご覧ください。