Menghubungkan IDE Anda ke AlloyDB menggunakan MCP Toolbox

Halaman ini menunjukkan cara menggunakan MCP Toolbox untuk database guna menghubungkan instance AlloyDB untuk PostgreSQL ke lingkungan pengembangan terintegrasi (IDE) dan alat developer yang mendukung Model Context Protocol (MCP). Gunakan alat ini untuk menjalankan kueri SQL dan berinteraksi dengan database Anda. Panduan ini ditujukan bagi developer yang menggunakan IDE dan alat developer yang ada untuk bekerja dengan AlloyDB.

Halaman ini mengasumsikan bahwa Anda memiliki database AlloyDB dan instance AlloyDB Anda memiliki alamat IP publik. Untuk mengetahui informasi selengkapnya, lihat Membuat Database AlloyDB dengan MCP Toolbox.

Model Context Protocol (MCP) adalah protokol terbuka untuk menghubungkan model bahasa besar (LLM) ke sumber data seperti AlloyDB. Halaman ini menjelaskan cara menggunakan MCP Toolbox for Databases untuk mengekspos alat bantuan 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

Pastikan Anda memiliki peran yang diperlukan.

Peran yang diperlukan

Untuk terhubung ke instance AlloyDB, Anda memerlukan peran berikut atau izin Identity and Access Management (IAM) yang setara:

• Klien AlloyDB Cloud (roles/alloydb.client)
• Pelanggan Penggunaan Layanan (roles/serviceusage.serviceUsageConsumer)

Menyiapkan database

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the 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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. Aktifkan Cloud API yang diperlukan untuk membuat dan menghubungkan ke AlloyDB untuk PostgreSQL.

   Aktifkan API

   1. Pada langkah Confirm project, klik Next untuk mengonfirmasi nama project yang akan Anda ubah.

   2. Pada langkah Enable APIs, klik Enable untuk mengaktifkan berikut ini:

      • AlloyDB API
      • Compute Engine API
      • Cloud Resource Manager API
      • Service Networking API

      Service Networking API diperlukan jika Anda berencana mengonfigurasi konektivitas jaringan ke AlloyDB menggunakan jaringan VPC yang berada di project yang sama Google Cloud dengan AlloyDB.

      Compute Engine API dan Cloud Resource Manager API diperlukan jika Anda berencana mengonfigurasi konektivitas jaringan ke AlloyDB menggunakan jaringan VPC yang berada di project Google Cloud lain.

2. Buat atau pilih cluster dan instance utamanya. MCP Toolbox terhubung dengan aman ke instance Anda menggunakan AlloyDB Language Connectors.
3. Konfigurasi Kredensial Default Aplikasi (ADC) untuk lingkungan Anda.
4. Buat atau gunakan kembali pengguna database. Siap untuk memasukkan nama pengguna dan sandi.

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.7.0 atau yang lebih baru.

   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. Jadikan biner sebagai file yang dapat dieksekusi.

   chmod +x toolbox
   

3. Verifikasi penginstalannya.

   ./toolbox --version
   

Mengonfigurasi klien MCP

Kode Claude

1. Instal Claude Code.
2. Buat file .mcp.json di root project Anda, jika tidak ada.
3. Tambahkan konfigurasi, ganti variabel lingkungan dengan nilai Anda, lalu simpan.




{
  "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

1. Buka Claude Desktop, lalu buka Settings.
2. Di tab Developer, klik Edit Config untuk membuka file konfigurasi.
3. Tambahkan konfigurasi, ganti variabel lingkungan dengan nilai Anda, lalu simpan.




{
  "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"
      }
    }
  }
}

4. Mulai ulang Claude Desktop.
5. Layar chat baru menampilkan ikon palu (MCP) dengan server MCP baru.

Cline

1. Buka ekstensi Cline di VS Code, lalu ketuk ikon MCP Servers.
2. Klik Configure MCP Servers untuk membuka file konfigurasi.
3. Tambahkan konfigurasi berikut, ganti variabel lingkungan dengan nilai Anda, lalu simpan.




{
  "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"
      }
    }
  }
}


Status aktif berwarna hijau akan muncul setelah server berhasil terhubung.



Kursor

1. Buat direktori .cursor di root project Anda jika belum ada.
2. Buat file .cursor/mcp.json jika tidak ada, lalu buka.
3. Tambahkan konfigurasi berikut, ganti variabel lingkungan dengan nilai Anda, lalu simpan.

{
  "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"
      }
    }
  } 
}

4. Buka Kursor, lalu buka Setelan > Setelan Kursor > MCP. Status aktif berwarna hijau akan muncul saat server terhubung.

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. Tambahkan konfigurasi berikut, ganti variabel lingkungan dengan nilai Anda, lalu simpan.

{
  "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"
      }
    }
  }
}

Selancar Angin

1. Buka Windsurf dan buka asisten Cascade.
2. Klik ikon MCP, lalu klik Configure untuk membuka file konfigurasi.
3. Tambahkan konfigurasi berikut, ganti variabel lingkungan dengan nilai Anda, lalu simpan.

{
  "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

1. Instal Gemini CLI.
2. Di direktori kerja Anda, buat folder bernama .gemini. Di dalamnya, buat file settings.json.
3. Tambahkan konfigurasi berikut, ganti variabel lingkungan dengan nilai Anda, lalu simpan.

{
  "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

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. Tambahkan konfigurasi berikut, ganti variabel lingkungan dengan nilai Anda, lalu simpan.

{
  "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"
      }
    }
  }
}

Menggunakan alat AI

Alat AI Anda kini terhubung ke AlloyDB menggunakan MCP. Coba minta asisten AI Anda untuk mencantumkan tabel, membuat tabel, atau menentukan dan menjalankan pernyataan SQL lainnya.

Alat berikut tersedia untuk LLM:

• list_tables: mencantumkan tabel dan deskripsi.
• execute_sql: menjalankan pernyataan SQL apa pun.
Catatan: Alat bawaan adalah alat pra-1.0, jadi perkirakan beberapa perubahan alat di antara versi. LLM beradaptasi dengan alat yang tersedia, sehingga hal ini tidak memengaruhi sebagian besar pengguna.