Crear una base de datos de AlloyDB con MCP Toolbox en el IDE

En esta página se describe cómo usar MCP Toolbox for Databases para crear y gestionar tus clústeres e instancias de AlloyDB para PostgreSQL desde entornos de desarrollo integrados (IDEs). Puedes usar herramientas para desarrolladores compatibles con Model Context Protocol (MCP).

Model Context Protocol (MCP) es un protocolo abierto para conectar modelos de lenguaje extensos (LLMs) a fuentes de datos y APIs, como la API de AlloyDB. Un asistente de IA es una interfaz de chat basada en un LLM que se encuentra en tu IDE y 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 mediante los siguientes IDEs:

Antes de empezar

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

  2. Comprueba que la facturación esté habilitada en tu Google Cloud proyecto. Consulta cómo comprobar si la facturación está habilitada en un proyecto.

  3. Habilita la API Admin de AlloyDB.

    Habilitar la API

Roles obligatorios

Para gestionar recursos de AlloyDB, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos en tu proyecto:

  • Administrador de AlloyDB (roles/alloydb.admin).
  • Consumidor del uso del servicio (roles/serviceusage.serviceUsageConsumer).

Instalar la caja de herramientas de MCP

  1. Descarga la versión más reciente de la caja de herramientas de MCP como archivo binario. Selecciona el binario correspondiente a tu sistema operativo y a la arquitectura de tu 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. Convierte el binario en un archivo ejecutable.

    chmod +x toolbox

  3. Verifica la instalación.

    ./toolbox --version

Configurar el cliente de MCP

Puedes configurar tu IDE para que use las herramientas del plano de control con el fin de crear y gestionar clústeres e instancias de AlloyDB. Si ya tienes una instancia de AlloyDB, sáltate este paso y ve a Conectar tu IDE a AlloyDB para PostgreSQL con MCP Toolbox. Las instancias se crean con una dirección IP pública mediante las herramientas del plano de control proporcionadas. Añade la siguiente configuración al archivo de ajustes de MCP de tu IDE. De esta forma, tu asistente de IA tendrá acceso a la herramienta alloydb-postgres-admin.

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. Genera un token de acceso para usarlo como API_KEY ejecutando gcloud auth print-access-token.
  1. Añade la siguiente configuración, sustituye API_KEY por el token generado y guarda los cambios.
{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Claude para ordenadores

  1. Abre Claude Desktop y ve a Configuración.
  2. En la pestaña Desarrollador, haz clic en Editar configuración para abrir el archivo de configuración.
  3. Genera un token de acceso para usarlo como API_KEY ejecutando gcloud auth print-access-token.

  1. Añade la siguiente configuración, sustituye API_KEY por el token generado y guarda los cambios.

{
  "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 toca el icono Servidores MCP.
  2. Toca Configurar servidores MCP para abrir el archivo de configuración.
  3. Genera un token de acceso para usarlo como API_KEY ejecutando gcloud auth print-access-token.

  1. Añade la siguiente configuración, sustituye API_KEY por el token generado y guarda los cambios.

{
  "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 de tu proyecto si no existe.
  2. Crea el archivo .cursor/mcp.json si no existe y ábrelo.
  3. Genera un token de acceso para usarlo como API_KEY ejecutando gcloud auth print-access-token.
  1. Añade la siguiente configuración, sustituye API_KEY por el token generado y guarda los cambios:

{
  "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. Genera un token de acceso para usarlo como API_KEY ejecutando gcloud auth print-access-token.
  1. Añade la siguiente configuración, sustituye API_KEY por el token generado y guarda los cambios.

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

Windsurf

  1. Abre Windsurf y ve al asistente de Cascade.
  2. Haz clic en el icono de MCP y, a continuación, en Configurar para abrir el archivo de configuración.
  3. Genera un token de acceso para usarlo como API_KEY ejecutando gcloud auth print-access-token.

  1. Añade la siguiente configuración, sustituye API_KEY por el token generado y guarda los cambios.

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

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. Genera un token de acceso para usarlo como API_KEY ejecutando gcloud auth print-access-token.

  1. Añade la siguiente configuración, sustituye API_KEY por el token generado y, a continuación, guarda los cambios.
{
  "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 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. Genera un token de acceso para usarlo como API_KEY ejecutando gcloud auth print-access-token.

  1. Añade la siguiente configuración, sustituye API_KEY por el token generado y, a continuación, guarda los cambios:

{
  "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 mediante MCP. Pide a tu asistente de IA que cree un clúster o una instancia.

Usar herramientas de administrador

El LLM tiene acceso a las siguientes herramientas:

  • alloydb-create-cluster: crea un clúster de AlloyDB.
  • alloydb-create-instance: crea una instancia de AlloyDB (PRIMARY, READ_POOL o SECONDARY).
  • alloydb-create-user: crea usuarios basados en ALLOYDB_BUILT_IN o IAM para un clúster de AlloyDB.
  • alloydb-get-operation: sondea la API de operaciones hasta que se completa la operación.
  • alloydb-list-clusters: muestra los clústeres de un proyecto y una ubicación determinados.
  • alloydb-list-instances: muestra las instancias de un proyecto y una ubicación determinados.
  • alloydb-list-users: muestra los usuarios de un proyecto y una ubicación determinados.

Conectarse a los datos

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