MCP Toolbox for Databases
Servidor MCP abierto de Google para conectar agentes con bases de datos mediante herramientas genéricas o consultas personalizadas agrupadas en toolsets.
Fuente: MCP Toolbox for Databases (Google) (fuente oficial) · Oficial · Mantiene Google · Licencia Apache-2.0 · Ver original en github.com
Ficha técnica
- Organización
- Google (se abre en una pestaña nueva)
- Transporte
- stdio o HTTP
- Instalación
npx @toolbox-sdk/server --config tools.yaml
Qué es y qué expone
MCP Toolbox for Databases es un servidor abierto que conecta agentes, entornos de desarrollo y aplicaciones con bases de datos. Tiene dos recorridos documentados: usar herramientas genéricas ya preparadas para explorar datos o definir herramientas propias con consultas y parámetros controlados. En ambos casos, el servidor sitúa una capa de herramientas entre el cliente y la base de datos.
El repositorio oficial se encuentra en googleapis/mcp-toolbox. El README explica que el nombre anterior era genai-toolbox y que se cambió para reflejar la compatibilidad MCP. Esta identidad importa al buscar el código, las instrucciones y los SDK: una referencia antigua puede conservar el nombre histórico, mientras que el perfil de esta ficha utiliza el repositorio canónico verificado.
Qué problema resuelve
Conectar un agente a datos empresariales requiere resolver más que una petición en lenguaje natural. Hay que definir qué datos puede consultar, qué operaciones se admiten y cómo se autentica la conexión. Toolbox ofrece herramientas genéricas para exploración y un framework de herramientas personalizadas para casos donde se necesita lógica predefinida, consultas estructuradas o búsqueda semántica.
La distinción ayuda a escoger el nivel de libertad del cliente. Una herramienta genérica de ejecución SQL ofrece un alcance diferente al de una consulta con parámetros definida para una tarea concreta. El servidor también gestiona aspectos de conexión y observabilidad, como el pool de conexiones, la autenticación integrada y las trazas. Estas capacidades forman parte de la integración, pero no reemplazan la selección de las operaciones que el agente debe poder usar.
Cómo funciona
La configuración personalizada se organiza alrededor de un archivo tools.yaml. Una fuente describe el origen de datos al que debe acceder el servidor. Una herramienta determina la acción, la fuente o fuentes afectadas y sus parámetros. Los toolsets agrupan herramientas que se cargan juntas para un agente o una aplicación. Separar estas responsabilidades permite definir una conexión y después decidir qué contratos se ofrecen a cada consumidor.
La vía predefinida reduce la configuración inicial: el cliente arranca el servidor con el tipo de base de datos seleccionado y las variables de conexión correspondientes. También se puede limitar la carga a un toolset concreto. Para aplicaciones propias, los SDK de cliente proporcionan el acceso a las herramientas del servidor; el mismo recurso puede, por tanto, formar parte de una experiencia de desarrollo o de una aplicación que necesita operaciones definidas sobre sus datos.
Tecnologías utilizadas
| Tecnología | Papel documentado |
|---|---|
| MCP | Integración de clientes con herramientas de bases de datos. |
| YAML | Definición de fuentes, herramientas y toolsets. |
| Node.js | Requisito de la vía de ejecución mediante npm. |
| Go | Compilación desde el repositorio. |
| OpenTelemetry | Métricas y trazas de la integración. |
| IAM | Autenticación integrada donde corresponde. |
Cómo empezar: requisitos e instalación
Elegir el modo.
Usar herramientas predefinidas para explorar una base compatible o definir herramientas propias con lógica y parámetros.
Preparar la conexión.
Configurar las variables de entorno que solicita la referencia de la base de datos elegida.
Añadir el bloque oficial.
El ejemplo incluido arranca la configuración predefinida de PostgreSQL mediante el paquete del servidor y transporte stdio.
Acotar las herramientas.
Revisar si conviene cargar solo un toolset o utilizar una consulta personalizada para la tarea.
Probar el contrato.
La interfaz Toolbox UI permite comprobar herramientas y grupos antes de integrarlos en una aplicación.
Estado del proyecto y licencia
El README declara Apache 2.0 y documenta el renombre oficial del repositorio, comprobado el 2026-10-25. El perfil enlaza la identidad mantenida actualmente. Para una instalación operativa, la guía distingue la comodidad de la ejecución mediante npm de las alternativas de binario y contenedor que propone como instalación más estándar y fiable.
La elección de distribución no cambia la necesidad de definir fuentes, herramientas y credenciales de conexión. El archivo de configuración describe el acceso a los datos y las acciones disponibles; el método con el que se inicia el servidor determina cómo se ejecuta ese contrato. Esta separación permite valorar la puesta en marcha sin confundir una instalación rápida con la configuración completa del acceso.
Herramientas expuestas
| Herramienta | Qué hace |
|---|---|
| list_tables | Herramienta genérica para explorar tablas de una base compatible. |
| execute_sql | Herramienta genérica para ejecutar SQL según la configuración. |
| search-hotels-by-name | Ejemplo personalizado del README que busca hoteles por nombre en PostgreSQL. |
El catálogo efectivo depende de la base, del modo predefinido y de los toolsets cargados. La herramienta de hoteles es un ejemplo de configuración, no una herramienta presente automáticamente en toda instalación.
Configuración
{
"mcpServers": {
"toolbox-postgres": {
"command": "npx",
"args": [
"-y",
"@toolbox-sdk/server",
"--prebuilt=postgres",
"--stdio"
]
}
}
}Ejemplo de uso
Ejemplo de KIRELEN (no oficial): preparar un agente que necesita buscar hoteles por nombre. El README muestra una herramienta personalizada asociada a una fuente de PostgreSQL, con un parámetro de nombre y una consulta preparada. La aplicación puede cargar el grupo de herramientas que corresponda y ofrecer al agente ese contrato, en lugar de asumir que necesita todas las operaciones genéricas de la base.
Para explorar un esquema durante el desarrollo, el recorrido puede ser diferente: utilizar las herramientas predefinidas y limitar la carga al grupo adecuado. En ambos casos, probar las entradas y observar las trazas permite revisar la integración. Esta ficha no ha conectado una base de datos ni presenta filas o resultados inventados; los ejemplos explican la configuración que documenta el proyecto.
Seguridad y límites
La capacidad de ejecutar SQL exige revisar el conjunto de herramientas y el acceso a la fuente. El framework permite lógica predefinida y consultas estructuradas, pero la configuración determina las acciones disponibles. Las variables de conexión deben corresponder al entorno previsto. La instalación rápida mediante npm prioriza comodidad y no sustituye la valoración del modo de ejecución operativo.
Comprobar la integración
Toolbox UI permite probar herramientas y toolsets, incluidos aspectos como los parámetros autorizados. Esta comprobación ayuda a revisar el contrato que recibirá la aplicación antes de incorporarlo al agente. La observabilidad cubre otro momento del recorrido: el servidor emite métricas y trazas con OpenTelemetry y permite exportarlas a un backend compatible con OTLP.
Las dos capacidades aportan información distinta. La interfaz de pruebas permite examinar una operación y sus entradas; las trazas y métricas permiten observar el comportamiento de la integración durante su ejecución. El uso de herramientas personalizadas y grupos acotados da un contexto más concreto a esa observación, porque explicita qué operaciones se han ofrecido y qué fuentes utiliza cada una.
Enlaces oficiales
Fuentes consultadas
Repositorio
Secundarias
- Descubrimiento: MCP Toolbox for Databases (Google) · skillsagentes.comFuente secundaria