Utilizzare Cloud SQL per SQL Server con MCP, Gemini CLI e altri agenti

Questa pagina mostra come connettere l'istanza Cloud SQL a vari strumenti di assistenza per sviluppatori AI, tra cui:

Per un'esperienza integrata, ti consigliamo di utilizzare l'estensione Gemini CLI per Cloud SQL per SQL Server dedicata.

In quanto interfaccia a riga di comando di nuova generazione di Google Cloud, Gemini CLI raggruppa il server MCP sottostante direttamente nell'estensione, il che semplifica l'installazione e la configurazione. Puoi configurare Gemini Code Assist per utilizzare l'interfaccia a riga di comando di Gemini, che offre vantaggi di configurazione simili nel tuo IDE.

Per altri strumenti per sviluppatori che supportano il Model Context Protocol (MCP), puoi connetterti configurando manualmente MCP Toolbox for Databases (Toolbox). Toolbox è un server MCP open source che connette gli agenti AI ai tuoi dati gestendo attività come l'autenticazione e il raggruppamento delle connessioni. In questo modo puoi interagire con i dati utilizzando il linguaggio naturale direttamente dall'IDE. Per questi strumenti, questo metodo fornisce funzionalità di interazione di base con il database.

Per maggiori informazioni, consulta Strumenti predefiniti e MCP Toolbox for Databases su GitHub.

Informazioni sull'interfaccia a riga di comando di Gemini e sulle estensioni

Gemini CLI è un agente AI open source progettato per assistere i flussi di lavoro di sviluppo aiutando con la programmazione, il debug, l'esplorazione dei dati e la creazione di contenuti. Fornisce un'interfaccia agentica per interagire con servizi di database e analisi e con i database open source più diffusi.

Come funzionano le estensioni

L'interfaccia a riga di comando di Gemini è altamente estensibile e consente l'aggiunta di nuovi strumenti e funzionalità tramite le estensioni. Puoi caricare le estensioni da un URL GitHub, da una directory locale o da un registro configurabile. Forniscono nuovi strumenti, comandi slash e prompt per assisterti nel tuo flusso di lavoro.

Utilizzare le estensioni della CLI Gemini in Cloud SQL per SQL Server

L'estensione CLI Gemini per Cloud SQL si basa su MCP Toolbox for Databases. MCP Toolbox for Databases è attualmente in versione beta (pre-v1.0) e potrebbe subire modifiche che causano interruzioni fino alla prima release stabile (v1.0).

L'integrazione con l'interfaccia a riga di comando di Gemini avviene tramite un'estensione dedicata che offre funzionalità aggiuntive rispetto alla connessione standard di Toolbox. L'estensione offre una procedura di installazione semplificata e un insieme di strumenti.

Per saperne di più, consulta la documentazione di GitHub per l'estensione Gemini CLI per Cloud SQL per SQL Server.

Estensione Gemini CLI per i database Cloud SQL per SQL Server

L'estensione cloud-sql-sqlserver include strumenti per eseguire query sul database e monitorarne l'integrità.

Categoria Strumenti
Operazioni del database
  • list_tables: elenca tutte le tabelle e le relative descrizioni trovate in un database.
  • execute_sql: esegue qualsiasi istruzione SQL.
Gestione delle risorse per istanze e utenti
  • create_user: crea un nuovo utente in un'istanza Cloud SQL.
  • list_user: elenca gli utenti Cloud SQL in un determinato progetto.
  • list_instances: elenca le istanze Cloud SQL in un determinato progetto.
  • get_instance: recupera i dettagli di una specifica istanza Cloud SQL.
  • get_user: recupera i dettagli di un utente Cloud SQL specifico.
  • create_instance: crea una nuova istanza Cloud SQL.
  • wait_for_operation: esegue il polling dell'API Operations finché un'operazione non viene completata.

L'estensione cloud-sql-sqlserver-observability fornisce un'interfaccia unificata per la gestione e il monitoraggio delle prestazioni e dell'integrità del database direttamente dalla Gemini CLI.

Categoria Strumenti
Osservabilità
  • get_system_metrics: recupera le metriche di sistema per un'istanza Cloud SQL.

Estensione dell'interfaccia a riga di comando di Gemini per i database SQL Server

Per un elenco di queste operazioni, consulta MCP Toolbox for Databases e l'estensione della CLI Gemini per SQL Server.

Prima di iniziare

Installare la casella degli strumenti MCP

  1. Per installare la raccolta di strumenti, scarica il file binario corrispondente al tuo sistema operativo e all'architettura della CPU.

    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. Rendi eseguibile il file binario:

    chmod +x toolbox

  3. Verifica l'installazione utilizzando il seguente comando:

    ./toolbox --version

Configura il client MCP

Questa sezione descrive come configurare vari strumenti per sviluppatori per connettersi alla tua istanza Cloud SQL utilizzando Toolbox. Toolbox funge da server Model Context Protocol (MCP) open source che si trova tra l'IDE e il database, fornendo un piano di controllo sicuro ed efficiente per i tuoi strumenti di AI. Seleziona la scheda dello strumento specifico per visualizzare le istruzioni di configurazione.

Interfaccia a riga di comando Gemini per Cloud SQL per SQL Server


1. Installa l'interfaccia a riga di comando di Gemini.
2. Installa l'estensione Cloud SQL per SQL Server per Gemini CLI dal repository GitHub utilizzando il seguente comando: 
      gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-sqlserver
3. Imposta le variabili di ambiente per connetterti all'istanza Cloud SQL: 
      export CLOUD_SQL_MSSQL_PROJECT="PROJECT_NAME"
      export CLOUD_SQL_MSSQL_REGION="REGION"
      export CLOUD_SQL_MSSQL_INSTANCE="INSTANCE_NAME"
      export CLOUD_SQL_MSSQL_DATABASE="DATABASE_NAME"
      export CLOUD_SQL_MSSQL_DATABASE="IP_ADDRESS"
      export CLOUD_SQL_MSSQL_USER="DATABASE_USER_NAME"
      export CLOUD_SQL_MSSQL_PASSWORD="PASSWORD"
      export CLOUD_SQL_MSSQL_IP_TYPE="IP_TYPE"
Sostituisci quanto segue:
  • PROJECT_NAME: L' Google Cloud ID progetto.
  • REGION: la regione dell'istanza Cloud SQL.
  • INSTANCE_NAME: l'ID dell'istanza Cloud SQL.
  • DATABASE_NAME: il nome del database a cui connettersi.
  • IP_ADDRESS: L'indirizzo IP dell'istanza a cui connettersi.
  • DATABASE_USER_NAME: (Facoltativo) il nome utente del database. Se non specificato, il valore predefinito è l'autenticazione IAM.
  • PASSWORD: (Facoltativo) la password per l'utente del database. Se non specificato, il valore predefinito è l'autenticazione IAM.
  • IP_TYPE: (facoltativo) il tipo di IP, ad esempio "Public" (pubblico, predefinito) o "Private" (privato).
4. Avvia l'interfaccia a riga di comando di Gemini in modalità interattiva: 
      gemini

La CLI carica automaticamente l'estensione Gemini CLI per Cloud SQL e i relativi strumenti, che puoi utilizzare per interagire con il database.

Nella Gemini CLI, utilizza il comando /extensions per verificare che l'estensione sia installata e il comando /mcp list per visualizzare gli strumenti.

Interfaccia a riga di comando di Gemini per SQL Server


1. Installa l'interfaccia a riga di comando di Gemini.
2. Installa l'estensione software SQL Server per Gemini CLI dal repository GitHub utilizzando il seguente comando: 
      gemini extensions install https://github.com/gemini-cli-extensions/sql-server
3. Imposta le variabili di ambiente per connetterti all'istanza SQL Server: 
      export MSSQL_HOST="HOST"
      export MSSQL_PORT="PORT"
      export MSSQL_DATABASE="DATABASE"
      export MSSQL_USER="USER"
      export MSSQL_PASSWORD="PASSWORD"
Sostituisci quanto segue:
  • HOST: il nome host o l'indirizzo IP del server SQL Server.
  • PORT: il numero di porta per il server SQL Server.
  • DATABASE: il nome del database a cui connettersi.
  • USER: Il nome utente del database.
  • PASSWORD: La password per l'utente del database.
4. Avvia l'interfaccia a riga di comando di Gemini in modalità interattiva: 
      gemini

La CLI carica automaticamente l'estensione della CLI Gemini per SQL Server e i relativi strumenti, che puoi utilizzare per interagire con il tuo database.

Gemini Code Assist


1. Installa l'estensione Gemini Code Assist in Visual Studio Code.
2. Attiva la modalità Agente nella chat di Gemini Code Assist.
3. Nella directory di lavoro, crea una cartella denominata .gemini. Al suo interno, crea un file settings.json.
4. Aggiungi la seguente configurazione, sostituisci le variabili di ambiente con i tuoi valori e poi salva:


{
  "mcpServers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

Codice Claude


1. Installa Claude Code.
2. Crea il file .mcp.json nella directory principale del progetto, se non esiste.
3. Aggiungi la configurazione, sostituisci le variabili di ambiente con i tuoi valori e salva: 


{
  "mcpServers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

Claude desktop


1. Apri Claude Desktop e vai a Impostazioni.
2. Nella scheda Sviluppatore, tocca Modifica configurazione per aprire il file di configurazione.
3. Aggiungi la configurazione, sostituisci le variabili di ambiente con i tuoi valori e salva: 


{
  "mcpServers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

5. Riavvia Claude Desktop.
6. Nella nuova schermata della chat viene visualizzata un'icona a forma di martello (MCP) con il nuovo server MCP disponibile.

Cline


1. Apri l'estensione Cline in VS Code e tocca l'icona Server MCP.
2. Tocca Configura server MCP per aprire il file di configurazione.
3. Aggiungi la seguente configurazione, sostituisci le variabili di ambiente con i tuoi valori e salva: 


{
  "mcpServers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

4. Dopo la connessione riuscita del server, viene visualizzato uno stato attivo verde.

Cursore


1. Crea la directory .cursor nella root del progetto, se non esiste.
2. Crea il file .cursor/mcp.json se non esiste e aprilo.
3. Aggiungi la seguente configurazione, sostituisci le variabili di ambiente con i tuoi valori e salva:


{
  "mcpServers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

4. Apri Cursore e vai a Impostazioni > Impostazioni cursore > MCP. Quando il server si connette, viene visualizzato uno stato attivo verde.

Visual Studio Code (Copilot)


1. Apri VS Code e crea la directory .vscode nella radice del progetto, se non esiste.
2. Crea il file .vscode/mcp.json se non esiste e aprilo.
3. Aggiungi la seguente configurazione, sostituisci le variabili di ambiente con i tuoi valori e salva: 


{
  "servers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

Windsurf


1. Apri Windsurf e vai all'assistente per le cascate.
2. Tocca l'icona MCP, poi tocca Configura per aprire il file di configurazione.
3. Aggiungi la seguente configurazione, sostituisci le variabili di ambiente con i tuoi valori e salva: 


{
  "mcpServers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}