Menggunakan Cloud SQL untuk MySQL dengan MCP, Gemini CLI, dan agen lainnya

Halaman ini menunjukkan cara menghubungkan instance Cloud SQL Anda ke berbagai alat bantuan developer AI, termasuk:

Untuk pengalaman terintegrasi, sebaiknya gunakan ekstensi CLI Gemini khusus untuk Cloud SQL untuk MySQL.

Sebagai antarmuka command-line generasi berikutnya, Gemini CLI menggabungkan server MCP pokok langsung ke dalam ekstensi, yang menyederhanakan penyiapan dan konfigurasi. Google CloudAnda dapat mengonfigurasi Gemini Code Assist untuk menggunakan Gemini CLI, yang menawarkan manfaat penyiapan serupa di IDE Anda.

Untuk alat developer lain yang mendukung Model Context Protocol (MCP), Anda dapat terhubung dengan mengonfigurasi MCP Toolbox for Databases (Toolbox) secara manual. Toolbox adalah server MCP open source yang menghubungkan agen AI ke data Anda dengan mengelola tugas seperti autentikasi dan penggabungan koneksi. Dengan demikian, Anda dapat berinteraksi dengan data menggunakan bahasa alami langsung dari IDE. Untuk alat ini, metode ini menyediakan kemampuan interaksi database inti.

Untuk mengetahui informasi selengkapnya, lihat Alat bawaan dan MCP Toolbox for Databases di GitHub.

Tentang Gemini CLI dan ekstensi

Gemini CLI adalah agen AI open source yang dirancang untuk membantu alur kerja pengembangan dengan membantu coding, proses debug, eksplorasi data, dan pembuatan konten. Alat ini menyediakan antarmuka berbasis agen untuk berinteraksi dengan layanan database dan analisis serta database open source populer.

Cara kerja ekstensi

Gemini CLI sangat mudah diperluas, sehingga memungkinkan penambahan alat dan kemampuan baru melalui ekstensi. Anda dapat memuat ekstensi dari URL GitHub, direktori lokal, atau registry yang dapat dikonfigurasi. Fitur ini menyediakan alat, perintah garis miring, dan perintah baru untuk membantu alur kerja Anda.

Menggunakan ekstensi CLI Gemini di Cloud SQL untuk MySQL

Ekstensi Cloud SQL Gemini CLI didasarkan pada MCP Toolbox for Databases. MCP Toolbox for Databases saat ini dalam versi beta (pra-v1.0), dan mungkin mengalami perubahan yang merusak hingga rilis stabil pertama (v1.0).

Integrasi dengan Gemini CLI dilakukan melalui ekstensi khusus yang menawarkan kemampuan tambahan dibandingkan dengan koneksi Toolbox standar. Ekstensi ini menawarkan proses penginstalan yang disederhanakan dan serangkaian alat.

Untuk mengetahui informasi selengkapnya, lihat dokumentasi GitHub untuk ekstensi Gemini CLI untuk Cloud SQL for MySQL.

Ekstensi Gemini CLI untuk database Cloud SQL untuk MySQL

Ekstensi cloud-sql-mysql mencakup alat untuk membuat kueri database dan memantau kondisi database.

Kategori Alat
Operasi database
  • list_tables: Mencantumkan semua tabel dan deskripsi yang sesuai yang ditemukan dalam database.
  • execute_sql: Menjalankan pernyataan SQL apa pun.
  • list_active_queries: Mencantumkan kueri yang sedang berjalan di instance Cloud SQL.
  • list_tables_missing_unique_indexes: Menemukan tabel tanpa kunci utama atau kunci unik.
  • list_table_fragmentation: Mendapatkan informasi fragmentasi tabel.
  • get_query_plan: Mendapatkan rencana kueri untuk satu pernyataan dari instance Cloud SQL.
Pengelolaan resource untuk instance & pengguna
  • create_user: Membuat pengguna baru di instance Cloud SQL.
  • list_databases: Mencantumkan semua database untuk instance Cloud SQL.
  • create_database: Membuat database baru dalam instance Cloud SQL.
  • list_instances: Mencantumkan instance Cloud SQL dalam project tertentu.
  • get_instance: Mendapatkan detail tentang instance Cloud SQL tertentu.
  • create_instance: Membuat instance Cloud SQL baru.
  • wait_for_operation: Melakukan polling API operasi hingga operasi selesai.

Ekstensi cloud-sql-mysql-observability menyediakan antarmuka terpadu untuk mengelola dan memantau performa serta kondisi database secara langsung dari Gemini CLI.

Kategori Alat
Kemampuan observasi
  • get_system_metrics: Mengambil metrik sistem untuk instance Cloud SQL.
  • get_query_metrics: Mengambil metrik terkait kueri untuk instance Cloud SQL.

Ekstensi Gemini CLI untuk database MySQL

Untuk mengetahui daftar operasi tersebut, lihat MCP Toolbox for Databases dan Ekstensi Gemini CLI untuk MySQL.

Sebelum memulai

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

  • Pastikan penagihan diaktifkan untuk Google Cloud project Anda.

  • Aktifkan Cloud SQL Admin API di Google Cloud project.

  • Secara default, Cloud SQL menetapkan alamat IP publik ke instance baru. Bergantung pada kasus penggunaan Anda, pastikan IP Publik atau IP Pribadi disiapkan untuk instance Cloud SQL Anda. Toolbox terhubung dengan aman menggunakan Cloud SQL Language Connectors.

  • Berikan peran Identity and Access Management (IAM) yang diperlukan kepada pengguna yang akan menjalankan server MCP. Alat yang tersedia bergantung pada peran yang diberikan:

    Tugas Nama peran Peran IAM yang diperlukan
    Memberikan akses hanya baca ke resource, termasuk operasi berikut:
    • get_instance
    • list_instances
    • list_databases
    • wait_for_operation
    		 Penampil Cloud SQL roles/cloudsql.viewer
    Memberikan akses hanya baca ke data pemantauan seperti metrik deret waktu. Cloud Monitoring Viewer roles/monitoring.viewer
    Memberikan izin untuk mengelola resource yang ada, termasuk hal berikut:
    • Semua alat viewer
    • create_database
    		 Cloud SQL Editor roles/cloudsql.editor
    Memberikan kontrol penuh atas semua resource, termasuk berikut ini:
    • Semua alat viewer dan editor
    • create_instance
    • create_user
    		 Admin Cloud SQL roles/cloudsql.admin

  • Konfigurasi Kredensial Default Aplikasi (ADC) untuk lingkungan Anda.

  • Buat atau gunakan kembali pengguna database, dan siapkan nama pengguna dan sandi.

Menginstal Toolbox MCP

  1. Untuk menginstal toolbox, download biner yang sesuai dengan sistem operasi dan arsitektur CPU Anda.

    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 penginstalan menggunakan perintah berikut:

    ./toolbox --version

Mengonfigurasi Klien MCP

Bagian ini menjelaskan cara mengonfigurasi berbagai alat developer untuk terhubung ke instance Cloud SQL Anda menggunakan Toolbox. Toolbox berfungsi sebagai server Model Context Protocol (MCP) open source yang berada di antara IDE dan database Anda, sehingga menyediakan bidang kontrol yang aman dan efisien untuk alat AI Anda. Pilih tab untuk alat spesifik Anda guna melihat petunjuk konfigurasi.

CLI Gemini untuk Cloud SQL untuk MySQL


1. Instal Gemini CLI.
2. Instal ekstensi Cloud SQL untuk MySQL bagi Gemini CLI dari repositori GitHub menggunakan perintah berikut: 
    gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-mysql
3. Tetapkan variabel lingkungan untuk terhubung ke instance Cloud SQL Anda: 
    export CLOUD_SQL_MYSQL_PROJECT="PROJECT_NAME"
    export CLOUD_SQL_MYSQL_REGION="REGION"
    export CLOUD_SQL_MYSQL_INSTANCE="INSTANCE_NAME"
    export CLOUD_SQL_MYSQL_DATABASE="DATABASE_NAME"
    export CLOUD_SQL_MYSQL_USER="DATABASE_USER_NAME"
    export CLOUD_SQL_MYSQL_PASSWORD="PASSWORD"
    export CLOUD_SQL_MYSQL_IP_TYPE="IP_TYPE"
Ganti kode berikut:
  • PROJECT_NAME: ID project Google Cloud .
  • REGION: Region instance Cloud SQL Anda.
  • INSTANCE_NAME: ID instance Cloud SQL Anda.
  • DATABASE_NAME: Nama database yang akan dihubungkan.
  • DATABASE_USER_NAME: Opsional: Nama pengguna database. Secara default adalah autentikasi IAM jika tidak ditentukan.
  • PASSWORD: Opsional: Sandi untuk pengguna database. Secara default adalah autentikasi IAM jika tidak ditentukan.
  • IP_TYPE: Opsional: Jenis IP, seperti "Public" (default) atau "Private".
4. Mulai Gemini CLI dalam mode interaktif: 
      gemini

CLI akan otomatis memuat ekstensi Gemini CLI untuk Cloud SQL dan alatnya, yang dapat Anda gunakan untuk berinteraksi dengan database.

Di Gemini CLI, gunakan perintah /extensions untuk memverifikasi bahwa ekstensi telah diinstal dan perintah /mcp list untuk melihat alat.

Gemini CLI untuk MySQL


1. Instal Gemini CLI.
2. Instal ekstensi software MySQL untuk Gemini CLI dari repositori GitHub menggunakan perintah berikut: 
      gemini extensions install https://github.com/gemini-cli-extensions/mysql
3. Tetapkan variabel lingkungan untuk terhubung ke instance MySQL Anda: 
      export MYSQL_HOST="HOST"
      export MYSQL_PORT="PORT"
      export MYSQL_DATABASE="DATABASE"
      export MYSQL_USER="USER"
      export MYSQL_PASSWORD="PASSWORD"
      export MYSQL_QUERY_PARAMETERS="QUERY_PARAMETERS"
Ganti kode berikut:
  • HOST: Nama host atau alamat IP server MySQL.
  • PORT: Nomor port untuk server MySQL.
  • DATABASE: Nama database yang akan dihubungkan.
  • USER: Nama pengguna database.
  • PASSWORD: Sandi untuk pengguna database.
  • QUERY_PARAMETERS: Opsional: Kueri mentah yang akan ditambahkan ke string koneksi db.
4. Mulai Gemini CLI dalam mode interaktif: 
      gemini

CLI akan otomatis memuat ekstensi Gemini CLI untuk MySQL dan alatnya, yang dapat Anda gunakan untuk berinteraksi dengan database Anda.

Gemini Code Assist


1. Instal ekstensi Gemini Code Assist di Visual Studio Code.
2. Aktifkan Mode Agen di percakapan 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": {
    "cloud-sql-mysql": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mysql","--stdio"],
      "env": {
          "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
          "CLOUD_SQL_MYSQL_REGION": "REGION",
          "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
          "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
          "CLOUD_SQL_MYSQL_USER": "USER_ID",
          "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

Kode Claude


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


{
  "mcpServers": {
    "cloud-sql-mysql": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mysql","--stdio"],
      "env": {
        "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MYSQL_REGION": "REGION",
        "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
        "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MYSQL_USER": "USER_ID",
        "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

Claude desktop


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


{
  "mcpServers": {
    "cloud-sql-mysql": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mysql","--stdio"],
      "env": {
        "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MYSQL_REGION": "REGION",
        "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
        "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MYSQL_USER": "USER_ID",
        "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

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

Cline


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


{
  "mcpServers": {
    "cloud-sql-mysql": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mysql","--stdio"],
      "env": {
        "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MYSQL_REGION": "REGION",
        "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
        "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MYSQL_USER": "USER_ID",
        "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

4. 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": {
    "cloud-sql-mysql": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mysql","--stdio"],
      "env": {
        "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MYSQL_REGION": "REGION",
        "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
        "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MYSQL_USER": "USER_ID",
        "CLOUD_SQL_MYSQL_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 belum ada, lalu buka.
3. Tambahkan konfigurasi berikut, ganti variabel lingkungan dengan nilai Anda, lalu simpan: 


{
  "servers": {
    "cloud-sql-mysql": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mysql","--stdio"],
      "env": {
        "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MYSQL_REGION": "REGION",
        "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
        "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MYSQL_USER": "USER_ID",
        "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

Selancar Angin


1. Buka Windsurf dan buka asisten Cascade.
2. Ketuk ikon MCP, lalu ketuk Konfigurasi untuk membuka file konfigurasi.
3. Tambahkan konfigurasi berikut, ganti variabel lingkungan dengan nilai Anda, lalu simpan: 


{
  "mcpServers": {
    "cloud-sql-mysql": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mysql","--stdio"],
      "env": {
          "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
          "CLOUD_SQL_MYSQL_REGION": "REGION",
          "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
          "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
          "CLOUD_SQL_MYSQL_USER": "USER_ID",
          "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}