Crea una base de datos de AlloyDB con el kit de herramientas de MCP en el IDE

En esta página, se describe cómo usar la caja de herramientas de MCP para bases de datos para crear y administrar tus clústeres e instancias de AlloyDB para PostgreSQL desde entornos de desarrollo integrados (IDE). Puedes usar herramientas para desarrolladores que admitan el Protocolo de contexto del modelo (MCP).

El Protocolo de contexto del modelo (MCP) es un protocolo abierto para conectar modelos de lenguaje grandes (LLM) a fuentes de datos y APIs, como la API de AlloyDB Admin. Un asistente de IA es una interfaz de chat potenciada por un LLM en tu IDE que te ayuda a alcanzar tus objetivos y completar tareas. En esta página, se describe cómo usar MCP Toolbox for Databases para exponer tus herramientas de asistente para desarrolladores a una instancia de AlloyDB con los siguientes IDEs:

• Cursor
• Windsurf (Codium)
• Visual Studio Code (Copilot)
• Cline (extensión de VS Code)
• Claude para computadoras
• Claude code
• CLI de Gemini
• Gemini Code Assist

Antes de comenzar

1. En la Google Cloud consola, en la página del selector de proyectos, selecciona o crea un Google Cloud proyecto.

2. Asegúrate de tener habilitada la facturación para tu Google Cloud proyecto. Obtén información para verificar si la facturación está habilitada en un proyecto.

3. Habilita la API de AlloyDB Admin.

   Habilitar la API

Roles requeridos

Para administrar recursos de AlloyDB, pídele a tu administrador que te otorgue los siguientes roles de Identity and Access Management en tu proyecto:

• Administrador de AlloyDB (roles/alloydb.admin).
• Consumidor de Service Usage (roles/serviceusage.serviceUsageConsumer).

Instala MCP Toolbox

1. Descarga la versión más reciente de MCP Toolbox como un archivo binario. Selecciona el objeto binario correspondiente a tu sistema operativo (SO) y a la arquitectura de CPU. Debes usar la versión V0.10.0 o una posterior de MCP Toolbox.

   linux/amd64

   curl -O https://storage.googleapis.com/genai-toolbox/v0.10.0/linux/amd64/toolbox

   darwin/arm64

   curl -O https://storage.googleapis.com/genai-toolbox/v0.10.0/darwin/arm64/toolbox

   darwin/amd64

   curl -O https://storage.googleapis.com/genai-toolbox/v0.10.0/darwin/amd64/toolbox

   windows/amd64

   curl -O https://storage.googleapis.com/genai-toolbox/v0.10.0/windows/amd64/toolbox

2. Haz que el objeto binario sea ejecutable.

   chmod +x toolbox
   

3. Verifica la instalación:.

   ./toolbox --version
   

Configura el cliente de MCP

Puedes configurar tu IDE para que use las herramientas del plano de control para crear y administrar clústeres e instancias de AlloyDB. Si ya tienes una instancia de AlloyDB, omite este paso y ve a Conecta tu IDE a AlloyDB para PostgreSQL con MCP Toolbox. Las instancias se crean con una dirección IP pública a través de las herramientas del plano de control proporcionadas. Agrega la siguiente configuración al archivo de configuración del MCP de tu IDE. Este enfoque expone la herramienta alloydb-postgres-admin a tu asistente de IA.

Código de Claude

1. Instala Claude Code.
2. Crea un archivo .mcp.json en la raíz de tu proyecto, si no existe.
3. Ejecuta gcloud auth print-access-token para generar un token de acceso que se usará como API_KEY.

Nota: La vida útil del token es de 1 hora.

4. Agrega la siguiente configuración, reemplaza API_KEY por el token generado y guarda.

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Claude para computadoras de escritorio

1. Abre Claude Desktop y navega a Configuración.
2. En la pestaña Desarrollador, haz clic en Editar configuración para abrir el archivo de configuración.
3. Ejecuta gcloud auth print-access-token para generar un token de acceso que se usará como API_KEY.

Nota: La vida útil del token es de 1 hora.

4. Agrega la siguiente configuración, reemplaza API_KEY por el token generado y guarda.

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Cline

1. Abre la extensión Cline en VS Code y presiona el ícono de Servidores de MCP.
2. Presiona Configure MCP Servers para abrir el archivo de configuración.
3. Ejecuta gcloud auth print-access-token para generar un token de acceso que se usará como API_KEY.

Nota: La vida útil del token es de 1 hora.

4. Agrega la siguiente configuración, reemplaza API_KEY por el token generado y guarda.

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Cursor

1. Crea el directorio .cursor en la raíz del proyecto si no existe.
2. Crea el archivo .cursor/mcp.json si no existe y ábrelo.
3. Ejecuta gcloud auth print-access-token para generar un token de acceso que se usará como API_KEY.

Nota: La vida útil del token es de 1 hora.

4. Agrega la siguiente configuración, reemplaza API_KEY por el token generado y guarda:

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Visual Studio Code (Copilot)

1. Abre VS Code y crea un 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. Ejecuta gcloud auth print-access-token para generar un token de acceso que se usará como API_KEY.

Nota: La vida útil del token es de 1 hora.

4. Agrega la siguiente configuración, reemplaza API_KEY por el token generado y guarda.

{
  "mcp":{
    "servers": {
      "alloydb-admin": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
        "env": {
          "API_KEY": "API_KEY"
        }
      }
    }
  }
}

Windsurf

1. Abre Windsurf y navega al asistente de Cascade.
2. Haz clic en el ícono de MCP y, luego, en Configurar para abrir el archivo de configuración.
3. Ejecuta gcloud auth print-access-token para generar un token de acceso que se usará como API_KEY.

Nota: La vida útil del token es de 1 hora.

4. Agrega la siguiente configuración, reemplaza API_KEY por el token generado y guarda.

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

CLI de Gemini

1. Instala la CLI de Gemini.
2. En tu directorio de trabajo, crea una carpeta llamada .gemini. Dentro de él, crea un archivo settings.json.
3. Ejecuta gcloud auth print-access-token para generar un token de acceso que se usará como API_KEY.

Nota: La vida útil del token es de 1 hora.

4. Agrega la siguiente configuración, reemplaza API_KEY por el token generado y, luego, guarda.

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Gemini Code Assist

1. Instala la extensión Gemini Code Assist en Visual Studio Code.
2. Habilita el modo de agente en el chat de Gemini Code Assist.
3. En tu directorio de trabajo, crea una carpeta llamada .gemini. Dentro de él, crea un archivo settings.json.
4. Ejecuta gcloud auth print-access-token para generar un token de acceso que se usará como API_KEY.

Nota: La vida útil del token es de 1 hora.

5. Agrega la siguiente configuración, reemplaza API_KEY por el token generado y, luego, guarda:

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Tu herramienta de IA ahora está conectada al plano de control de AlloyDB para PostgreSQL a través de MCP. Pídele a tu asistente de IA que cree un clúster o una instancia.

Usa herramientas de administrador

Las siguientes herramientas están disponibles para el LLM:

• alloydb-create-cluster: Crea un clúster de AlloyDB.
• alloydb-create-instance: Crea una instancia de AlloyDB (PRIMARY, READ_POOL o SECONDARY).
• alloydb-get-operation: Sondea la API de Operations hasta que finalice la operación.

Conéctate a tus datos

Después de configurar un clúster y una instancia de AlloyDB, puedes conectar tu IDE a la base de datos para consultar tus datos. Para obtener más información, consulta Conecta tu IDE a AlloyDB con MCP Toolbox.