En esta guía se explica cómo usar MCP Toolbox for Databases para conectar tu instancia de Cloud SQL a varios entornos de desarrollo integrados (IDEs) y herramientas para desarrolladores que admitan Model Context Protocol (MCP). Usa estas herramientas para ejecutar consultas de SQL e interactuar con tu base de datos.
Model Context Protocol (MCP) es un protocolo abierto para conectar modelos de lenguaje extensos (LLMs) a fuentes de datos como Cloud SQL. Los IDEs compatibles son los siguientes:
- Cursor
- Windsurf
- Visual Studio Code (Copilot)
- Cline(extensión de VS Code)
- Claude para ordenadores
- Código de Claude
- Gemini CLI
- Gemini Code Assist
Antes de empezar
En la Google Cloud consola, en la página del selector de proyectos, selecciona o crea un proyecto Google Cloud .
Asegúrate de que la facturación esté habilitada en tu Google Cloud proyecto.
Habilita la API Admin de Cloud SQL en el Google Cloudproyecto.
Comprueba que la IP pública esté configurada en la instancia de Cloud SQL. De forma predeterminada, Cloud SQL asigna una dirección IP pública a una instancia nueva. Toolbox se conecta de forma segura mediante los conectores de lenguaje de Cloud SQL.
Configura los roles y permisos necesarios para completar esta tarea. Necesitas el rol Cliente de Cloud SQL (
roles/cloudsql.client) o permisos de Gestión de Identidades y Accesos equivalentes para conectarte a la instancia.Configura las credenciales predeterminadas de la aplicación (ADC) para tu entorno.
Crea o reutiliza un usuario de base de datos y ten a mano el nombre de usuario y la contraseña.
Instalar la caja de herramientas de MCP
Para instalar la caja de herramientas, descarga el archivo binario que corresponda a tu sistema operativo y a la arquitectura de tu 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
Haz que el archivo binario sea ejecutable:
chmod +x toolboxVerifica la instalación con el siguiente comando:
./toolbox --version
Configurar el cliente de MCP
Código de Claude
1. Instala Claude Code.
2. Crea el archivo
.mcp.json en la raíz de tu proyecto si no existe. 3. Añade la configuración, sustituye las variables de entorno por tus valores y guarda los cambios:
{
"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 para ordenadores
1. Abre Claude Desktop y ve a Configuración.
2. En la pestaña Desarrollador, toca Editar configuración para abrir el archivo de configuración.
3. Añade la configuración, sustituye las variables de entorno por tus valores y guarda los cambios:
{
"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. Reinicia Claude Desktop.
6. En la nueva pantalla de chat se muestra un icono de martillo (MCP) con el nuevo servidor MCP disponible.
Cline
1. Abre la extensión Cline en VS Code y toca el icono Servidores MCP.
2. Toca Configurar servidores MCP para abrir el archivo de configuración.
3. Añade la siguiente configuración, sustituye las variables de entorno por tus valores y guarda los cambios:
{
"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. Si el servidor se conecta correctamente, aparecerá el estado activo en verde.
Cursor
1. Crea el directorio
.cursor en la raíz de tu proyecto si no existe. 2. Crea el archivo
.cursor/mcp.json si no existe y ábrelo.3. Añade la siguiente configuración, sustituye las variables de entorno por tus valores y guarda los cambios:
{
"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. Abre Cursor y ve a Configuración > Configuración del cursor > MCP. Cuando el servidor se conecta, aparece el estado activo en verde.
Visual Studio Code (Copilot)
1. Abre VS Code y crea el directorio
.vscode en la raíz de tu proyecto si no existe. 2. Crea el archivo
.vscode/mcp.json si no existe y ábrelo. 3. Añade la siguiente configuración, sustituye las variables de entorno por tus valores y guarda los cambios:
{
"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"
}
}
}
}
Windsurf
1. Abre Windsurf y ve al asistente de Cascade.
2. Toca el icono de MCP y, a continuación, Configurar para abrir el archivo de configuración.
3. Añade la siguiente configuración, sustituye las variables de entorno por tus valores y guarda los cambios:
{
"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"
}
}
}
}
Gemini CLI
1. Instala la CLI de Gemini.
2. En tu directorio de trabajo, crea una carpeta llamada
.gemini. En ella, crea un archivo settings.json.3. Añade la siguiente configuración, sustituye las variables de entorno por tus valores y, a continuación, guarda los cambios:
{
"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"
}
}
}
}
Gemini Code Assist
1. Instala la extensión Gemini Code Assist en Visual Studio Code.
2. Habilita el modo Agente en el chat de Gemini Code Assist.
3. En tu directorio de trabajo, crea una carpeta llamada
.gemini. En ella, crea un archivo settings.json.4. Añade la siguiente configuración, sustituye las variables de entorno por tus valores y, a continuación, guarda los cambios:
{
"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"
}
}
}
}
Usar herramientas
Tu herramienta de IA ahora está conectada a Cloud SQL mediante MCP. Prueba a pedirle a tu asistente de IA que muestre las tablas, cree una tabla o defina y ejecute otras instrucciones de SQL.
El LLM tiene acceso a las siguientes herramientas:
- list_tables muestra las tablas y las descripciones.
- execute_sql ejecuta cualquier instrucción SQL.