Membuat database AlloyDB menggunakan MCP Toolbox di IDE

Halaman ini menjelaskan cara menggunakan MCP Toolbox for Databases untuk membuat dan mengelola cluster dan instance AlloyDB for PostgreSQL dari lingkungan pengembangan terintegrasi (IDE). Anda dapat menggunakan alat developer yang mendukung Model Context Protocol (MCP).

Model Context Protocol (MCP) adalah protokol terbuka untuk menghubungkan model bahasa besar (LLM) ke sumber data dan API seperti AlloyDB Admin API. Asisten AI adalah antarmuka chat yang didukung LLM di IDE Anda yang membantu Anda mencapai sasaran dan menyelesaikan tugas. Halaman ini menjelaskan cara menggunakan MCP Toolbox for Databases untuk mengekspos alat asisten developer ke instance AlloyDB menggunakan IDE berikut:

• Cursor
• Windsurf (Codium)
• Visual Studio Code (Copilot)
• Cline (ekstensi VS Code)
• Claude desktop
• Kode Claude
• Gemini CLI
• Gemini Code Assist

Sebelum memulai

1. Di konsol Google Cloud , pada halaman pemilih project, pilih atau buat Google Cloud project.

2. Pastikan penagihan diaktifkan untuk Google Cloud project Anda. Pelajari cara memeriksa apakah penagihan telah diaktifkan pada suatu project.

3. Aktifkan AlloyDB Admin API.

   Mengaktifkan API

Peran yang diperlukan

Untuk mengelola resource AlloyDB, minta administrator Anda untuk memberi Anda peran Identity and Access Management berikut pada project Anda:

• Admin AlloyDB (roles/alloydb.admin).
• Service Usage Consumer (roles/serviceusage.serviceUsageConsumer).

Menginstal Toolbox MCP

1. Download MCP Toolbox versi terbaru sebagai biner. Pilih biner yang sesuai dengan sistem operasi (OS) dan arsitektur CPU Anda. Anda harus menggunakan MCP Toolbox versi V0.10.0 atau yang lebih baru.

   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

2. Jadikan biner sebagai file yang dapat dieksekusi.

   chmod +x toolbox
   

3. Verifikasi penginstalannya.

   ./toolbox --version
   

Mengonfigurasi klien MCP

Anda dapat mengonfigurasi IDE untuk menggunakan alat bidang kontrol guna membuat dan mengelola cluster dan instance AlloyDB. Jika Anda sudah memiliki instance AlloyDB, lewati langkah ini dan buka Menghubungkan IDE Anda ke AlloyDB untuk PostgreSQL menggunakan MCP Toolbox. Instance dibuat dengan alamat IP publik menggunakan alat bidang kontrol yang diberikan. Tambahkan konfigurasi berikut ke file setelan MCP IDE Anda. Pendekatan ini mengekspos alat alloydb-postgres-admin ke asisten AI Anda.

Kode Claude

1. Instal Claude Code.
2. Buat file .mcp.json di root project Anda, jika belum ada.
3. Buat token akses untuk digunakan sebagai API_KEY dengan menjalankan gcloud auth print-access-token.

Catatan: Masa aktif token adalah 1 jam.

4. Tambahkan konfigurasi berikut, ganti API_KEYdengan token yang dihasilkan, lalu simpan.

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Claude desktop

1. Buka Claude Desktop, lalu buka Settings.
2. Di tab Developer, klik Edit Config untuk membuka file konfigurasi.
3. Buat token akses untuk digunakan sebagai API_KEY dengan menjalankan gcloud auth print-access-token.

Catatan: Masa aktif token adalah 1 jam.

4. Tambahkan konfigurasi berikut, ganti API_KEY dengan token yang dihasilkan, lalu simpan.

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Cline

1. Buka ekstensi Cline di VS Code, lalu ketuk ikon MCP Servers.
2. Ketuk Configure MCP Servers untuk membuka file konfigurasi.
3. Buat token akses untuk digunakan sebagai API_KEY dengan menjalankan gcloud auth print-access-token.

Catatan: Masa aktif token adalah 1 jam.

4. Tambahkan konfigurasi berikut, ganti API_KEY dengan token yang dihasilkan, lalu simpan.

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Kursor

1. Buat direktori .cursor di root project Anda jika belum ada.
2. Buat file .cursor/mcp.json jika tidak ada, lalu buka.
3. Buat token akses untuk digunakan sebagai API_KEY dengan menjalankan gcloud auth print-access-token.

Catatan: Masa aktif token adalah 1 jam.

4. Tambahkan konfigurasi berikut, ganti API_KEY dengan token yang dihasilkan, lalu simpan:

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Visual Studio Code (Copilot)

1. Buka VS Code dan buat direktori .vscode di root project Anda jika belum ada.
2. Buat file .vscode/mcp.json jika tidak ada, lalu buka.
3. Buat token akses untuk digunakan sebagai API_KEY dengan menjalankan gcloud auth print-access-token.

Catatan: Masa aktif token adalah 1 jam.

4. Tambahkan konfigurasi berikut, ganti API_KEY dengan token yang dihasilkan, lalu simpan.

{
  "mcp":{
    "servers": {
      "alloydb-admin": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
        "env": {
          "API_KEY": "API_KEY"
        }
      }
    }
  }
}

Selancar Angin

1. Buka Windsurf dan buka asisten Cascade.
2. Klik ikon MCP, lalu klik Configure untuk membuka file konfigurasi.
3. Buat token akses untuk digunakan sebagai API_KEY dengan menjalankan gcloud auth print-access-token.

Catatan: Masa aktif token adalah 1 jam.

4. Tambahkan konfigurasi berikut, ganti API_KEY dengan token yang dihasilkan, lalu simpan.

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Gemini CLI

1. Instal Gemini CLI.
2. Di direktori kerja Anda, buat folder bernama .gemini. Di dalamnya, buat file settings.json.
3. Buat token akses untuk digunakan sebagai API_KEY dengan menjalankan gcloud auth print-access-token.

Catatan: Masa aktif token adalah 1 jam.

4. Tambahkan konfigurasi berikut, ganti API_KEY dengan token yang dihasilkan, lalu simpan.

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Gemini Code Assist

1. Instal ekstensi Gemini Code Assist di Visual Studio Code.
2. Aktifkan Mode Agen di chat Gemini Code Assist.
3. Di direktori kerja Anda, buat folder bernama .gemini. Di dalamnya, buat file settings.json.
4. Buat token akses untuk digunakan sebagai API_KEY dengan menjalankan gcloud auth print-access-token.

Catatan: Masa aktif token adalah 1 jam.

5. Tambahkan konfigurasi berikut, ganti API_KEY dengan token yang dihasilkan, lalu simpan:

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Alat AI Anda kini terhubung ke bidang kontrol AlloyDB untuk PostgreSQL menggunakan MCP. Minta asisten AI Anda untuk membuat cluster atau instance.

Menggunakan alat administrator

Alat berikut tersedia untuk LLM:

• alloydb-create-cluster: membuat cluster AlloyDB.
• alloydb-create-instance: membuat instance AlloyDB (PRIMARY, READ_POOL, atau SECONDARY).
• alloydb-get-operation: melakukan polling API operasi hingga operasi selesai.

Menghubungkan ke data Anda

Setelah menyiapkan cluster dan instance AlloyDB, Anda dapat menghubungkan IDE ke database untuk membuat kueri data. Untuk mengetahui informasi selengkapnya, lihat Menghubungkan IDE Anda ke AlloyDB menggunakan MCP Toolbox.