Guía para principiantes de Google MCP Toolbox para bases de datos

Introducción a la Caja de Herramientas MCP

La Caja de Herramientas MCP es una herramienta gratuita de Google que ayuda a tus aplicaciones de IA a comunicarse con tus bases de datos. Piensa en ella como un traductor especial. Tu IA puede solicitar información de manera sencilla, y la Caja de Herramientas MCP traduce esa solicitud al lenguaje que tu base de datos entiende, como SQL. Utiliza algo llamado Protocolo de Contexto de Modelo (MCP), que es simplemente un conjunto estándar de reglas para este tipo de comunicación.

Por Qué Deberías Usar la Caja de Herramientas MCP

La Caja de Herramientas MCP no es solo un traductor; también facilita y mejora mucho la creación de tus aplicaciones de IA.

La Caja de Herramientas MCP Simplifica Tu Código

Sin la Caja de Herramientas MCP, tienes que escribir mucho código solo para conectar tu IA a tu base de datos. Necesitas código para la conexión, para el manejo de errores y para la seguridad. Con la Caja de Herramientas MCP, simplemente defines tus acciones de base de datos en un archivo de texto simple llamado tools.yaml. Este archivo le dice a la caja de herramientas qué acciones son posibles, y la caja de herramientas se encarga de todo el trabajo pesado de conectarse a la base de datos de forma segura.

La Caja de Herramientas MCP Mejora la Velocidad y la Seguridad

La Caja de Herramientas MCP está diseñada para ser rápida. Utiliza una técnica llamada "agrupación de conexiones" (connection pooling), lo que significa que mantiene las conexiones de la base de datos abiertas y las reutiliza. Esto ahorra mucho tiempo en comparación con abrir una nueva conexión para cada solicitud. También es segura porque gestionas todo el acceso a la base de datos en un lugar central, reduciendo el riesgo de errores.

La Caja de Herramientas MCP Te Muestra lo Que Está Sucediendo

Cuando tienes una IA, una caja de herramientas y una base de datos trabajando juntas, puede ser difícil ver lo que está sucediendo. La Caja de Herramientas MCP tiene soporte integrado para la "observabilidad", lo que significa que puede crear registros y rastros de cada acción. Esto te ayuda a entender lo que están haciendo tus herramientas, encontrar cualquier problema y ver cómo hacer las cosas más rápido.

Cómo Encaja la Caja de Herramientas MCP en Tu Proyecto

La Caja de Herramientas MCP se sitúa en el centro de tu aplicación. El flujo es el siguiente:

1. Tu Aplicación de IA: Aquí es donde reside tu modelo de IA. Decide que necesita información de la base de datos para responder una pregunta.
2. La Caja de Herramientas MCP: La aplicación de IA envía una solicitud a la Caja de Herramientas MCP. La caja de herramientas busca en su archivo tools.yaml, encuentra la herramienta adecuada para la tarea y ejecuta el comando correspondiente en tu base de datos.
3. Tu Base de Datos: La base de datos ejecuta el comando y envía los datos de vuelta a la Caja de Herramientas MCP, que luego los pasa a tu IA.

Esta configuración significa que tu aplicación principal de IA no necesita conocer los detalles complejos de cómo funciona tu base de datos. Incluso puedes cambiar tus herramientas o base de datos sin tener que reescribir el código de tu aplicación de IA.

Guía Paso a Paso para Usar la Caja de Herramientas MCP

Repasemos cómo hacer que la Caja de Herramientas MCP funcione en tu ordenador.

Paso 1: Prepara Tu Base de Datos para la Caja de Herramientas MCP

Primero, necesitas una base de datos. Estos pasos usan PostgreSQL como ejemplo. Crearás un usuario especial y una base de datos para que la caja de herramientas los utilice.

Conéctate a tu servidor PostgreSQL.

Ejecuta estos comandos SQL para crear un usuario llamado toolbox_user y una base de datos llamada toolbox_db:

CREATE USER toolbox_user WITH PASSWORD 'my-password';
CREATE DATABASE toolbox_db;
GRANT ALL PRIVILEGES ON DATABASE toolbox_db TO toolbox_user;

Crea una tabla de ejemplo, como una tabla hotels, para que tus herramientas tengan algunos datos con los que trabajar.

Paso 2: Instala y Configura la Caja de Herramientas MCP

A continuación, configurarás la caja de herramientas.

Descarga el programa de la Caja de Herramientas MCP desde su página oficial de lanzamiento en GitHub. Asegúrate de obtener la versión correcta para tu ordenador (como Windows, Mac o Linux).

Crea un nuevo archivo llamado tools.yaml. Este archivo es donde definirás todas las acciones que tu IA puede realizar. Aquí tienes un ejemplo sencillo:

sources:
  my-pg-source:
    kind: postgres
    host: 127.0.0.1
    port: 5432
    database: toolbox_db
    user: toolbox_user
    password: my-password

tools:
  search-hotels-by-location:
    kind: postgres-sql
    source: my-pg-source
    description: Finds hotels in a specific city.
    parameters:
      - name: location
        type: string
        description: The city to search for hotels in.
    statement: SELECT * FROM hotels WHERE location = $1;

Paso 3: Ejecuta el Servidor de la Caja de Herramientas MCP

Ahora puedes iniciar la caja de herramientas. Abre tu terminal, ve a la carpeta donde descargaste la caja de herramientas y ejecuta este comando:

./toolbox --tools-file "tools.yaml"

El servidor se iniciará y cargará las herramientas que definiste.

Cómo Probar con el Inspector de la Caja de Herramientas MCP

La Caja de Herramientas MCP viene con una herramienta de prueba llamada Inspector. Esta es una página web que te permite probar tus herramientas sin tener que escribir ningún código.

1. Ejecuta el Inspector desde tu terminal con este comando: npx @modelcontextprotocol/inspector.
2. Abre la dirección web que te proporciona en tu navegador.
3. Indícale que se conecte a tu servidor de la Caja de Herramientas MCP en ejecución (normalmente en http://127.0.0.1:5000/mcp/sse).
4. Una vez conectado, puedes ver una lista de tus herramientas, rellenar sus parámetros y ejecutarlas para ver si funcionan correctamente.

Cómo Conectar Tu Aplicación a la Caja de Herramientas MCP

Después de la prueba, puedes conectar tu aplicación de IA real. La Caja de Herramientas MCP tiene SDKs (kits de desarrollo de software) para facilitar esto. Aquí tienes un ejemplo sencillo de Python:

Instala el SDK de Python: pip install toolbox-core.

Usa este código para conectarte a la caja de herramientas y cargar tus herramientas:

from toolbox_core import ToolboxClient
import asyncio

async def main():
    async with ToolboxClient("http://127.0.0.1:5000") as client:
        tools = await client.load_toolset()
        # The 'tools' variable now holds your database tools
        # and you can give them to your AI model.
        print("Tools loaded successfully!")

asyncio.run(main())

Este código se conecta al servidor de la caja de herramientas y descarga las herramientas que definiste. Luego puedes darle estas herramientas a tu agente de IA, y este podrá usarlas para interactuar con tu base de datos.

Consideraciones Finales sobre la Caja de Herramientas MCP

La Caja de Herramientas MCP de Google es una herramienta fantástica para cualquier desarrollador que trabaje con IA y bases de datos. Simplifica tu código, hace que tu aplicación sea más rápida y segura, y te da la visibilidad que necesitas para entender cómo funciona todo. Siguiendo los pasos de esta guía, puedes empezar a usar la Caja de Herramientas MCP para construir aplicaciones de IA más potentes y basadas en datos.