Questa guida mostra come utilizzare MCP Toolbox for Databases per connettere l'istanza Cloud SQL a vari ambienti di sviluppo integrati (IDE) e strumenti per sviluppatori che supportano il Model Context Protocol (MCP). Utilizza questi strumenti per eseguire query SQL e interagire con il database.
Il Model Context Protocol (MCP) è un protocollo aperto per connettere modelli linguistici di grandi dimensioni (LLM) a origini dati come Cloud SQL. Gli IDE supportati sono:
- Cursore
- Windsurf
- Visual Studio Code (Copilot)
- Cline(estensione VS Code)
- Claude desktop
- Claude code
- Gemini CLI
- Gemini Code Assist
Prima di iniziare
Nella console Google Cloud , nella pagina del selettore di progetti, seleziona o crea un progetto Google Cloud .
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
Verifica che l'IP pubblico sia configurato per l'istanza Cloud SQL. Per impostazione predefinita, Cloud SQL assegna un indirizzo IP pubblico a una nuova istanza. Toolbox si connette in modo sicuro utilizzando i connettori dei linguaggi di Cloud SQL.
Configura i ruoli e le autorizzazioni richiesti per completare questa attività. Per connetterti all'istanza, devi disporre del ruolo Cloud SQL > Client (
roles/cloudsql.client) o di autorizzazioni Identity and Access Management equivalenti.Configura le credenziali predefinite dell'applicazione (ADC) per il tuo ambiente.
Crea o riutilizza un utente di database e tieni a portata di mano il nome utente e la password.
Installare la casella degli strumenti MCP
Per installare la toolbox, 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
Rendi eseguibile il file binario:
chmod +x toolboxVerifica l'installazione utilizzando il seguente comando:
./toolbox --version
Configurare il client MCP
Codice Claude
1. Installa Claude Code.
2. Crea il file
.mcp.json nella radice del progetto se non esiste. 3. Aggiungi la configurazione, sostituisci le variabili di ambiente con i tuoi valori e salva:
{
"mcpServers": {
"cloud-sql-postgres": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-postgres","--stdio"],
"env": {
"CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
"CLOUD_SQL_POSTGRES_REGION": "REGION",
"CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_POSTGRES_USER": "USER_ID",
"CLOUD_SQL_POSTGRES_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-postgres": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-postgres","--stdio"],
"env": {
"CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
"CLOUD_SQL_POSTGRES_REGION": "REGION",
"CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_POSTGRES_USER": "USER_ID",
"CLOUD_SQL_POSTGRES_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-postgres": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-postgres","--stdio"],
"env": {
"CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
"CLOUD_SQL_POSTGRES_REGION": "REGION",
"CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_POSTGRES_USER": "USER_ID",
"CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
}
}
}
}
4. Dopo la connessione riuscita del server, viene visualizzato uno stato attivo verde.
Cursore
1. Crea la directory
.cursor nella radice 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-postgres": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-postgres","--stdio"],
"env": {
"CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
"CLOUD_SQL_POSTGRES_REGION": "REGION",
"CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_POSTGRES_USER": "USER_ID",
"CLOUD_SQL_POSTGRES_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:
{
"mcp": {
"servers": {
"cloud-sql-postgres": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-postgres","--stdio"],
"env": {
"CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
"CLOUD_SQL_POSTGRES_REGION": "REGION",
"CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_POSTGRES_USER": "USER_ID",
"CLOUD_SQL_POSTGRES_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-postgres": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-postgres","--stdio"],
"env": {
"CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
"CLOUD_SQL_POSTGRES_REGION": "REGION",
"CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_POSTGRES_USER": "USER_ID",
"CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD">
}
}
}
}
Interfaccia a riga di comando Gemini
1. Installa la Gemini CLI.
2. Nella directory di lavoro, crea una cartella denominata
.gemini. Al suo interno, crea un file settings.json.3. Aggiungi la seguente configurazione, sostituisci le variabili di ambiente con i tuoi valori e poi salva:
{
"mcpServers": {
"cloud-sql-postgres": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-postgres","--stdio"],
"env": {
"CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
"CLOUD_SQL_POSTGRES_REGION": "REGION",
"CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_POSTGRES_USER": "USER_ID",
"CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD">
}
}
}
}
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-postgres": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-postgres","--stdio"],
"env": {
"CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
"CLOUD_SQL_POSTGRES_REGION": "REGION",
"CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_POSTGRES_USER": "USER_ID",
"CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD">
}
}
}
}
Utilizzare gli strumenti
Il tuo strumento di AI è ora connesso a Cloud SQL tramite MCP. Prova a chiedere all'assistente AI di elencare le tabelle, creare una tabella o definire ed eseguire altre istruzioni SQL.
Sono disponibili i seguenti strumenti per il LLM:
- list_tables: elenca le tabelle e le descrizioni
- execute_sql: esegui qualsiasi istruzione SQL