Repolode
googleapis

googleapis/mcp-toolbox

Servidor MCP de código abierto que conecta agentes de IA, IDE y aplicaciones con bases de datos mediante herramientas predefinidas o definiciones personalizadas.

Estrellas
16,681
Forks
1,765
Issues abiertos
396
Último commit
hace 3 días

¿Qué es?

MCP Toolbox for Databases es un servidor de código abierto del Model Context Protocol que permite a agentes de IA, asistentes de IDE y aplicaciones acceder a bases de datos. Ejecútalo con una opción predefinida para una base de datos determinada, como --prebuilt=postgres, y clientes MCP como Gemini CLI, Claude Code o Codex obtendrán herramientas genéricas para listar tablas, ejecutar SQL y explorar esquemas.

Para entornos de producción, el proyecto también funciona como un framework para crear herramientas personalizadas. Los desarrolladores definen fuentes, herramientas, conjuntos de herramientas, prompts y recursos en un archivo tools.yaml, con sentencias SQL parametrizadas y acceso restringido. Los SDK de cliente para Python, JavaScript/TypeScript, Go y Java cargan estas herramientas en frameworks como LangChain, LlamaIndex, Genkit y ADK.

El servidor es compatible con una amplia variedad de bases de datos, como PostgreSQL, MySQL, BigQuery, Spanner, MongoDB, Redis, Elasticsearch y ClickHouse. Gestiona la agrupación de conexiones, la autenticación basada en IAM y las métricas y trazas de OpenTelemetry, e incluye una interfaz de usuario integrada para probar herramientas.

Funciones clave

  • 01Herramientas genéricas predefinidas para bases de datos populares, disponibles desde IDE y CLI compatibles con MCP
  • 02Definiciones de herramientas personalizadas en YAML, con SQL parametrizado, conjuntos de herramientas y prompts
  • 03SDK de cliente para Python, JavaScript/TypeScript, Go y Java
  • 04Autenticación integrada con IAM y agrupación de conexiones
  • 05Exportación de métricas y trazas de OpenTelemetry
  • 06Interfaz interactiva para probar herramientas y conjuntos de herramientas

Casos de uso

  • Permitir que un asistente de programación con IA explore el esquema de PostgreSQL o MySQL y escriba código adaptado a la base de datos
  • Proporcionar a un agente de producción unas pocas herramientas SQL parametrizadas y restringidas, en lugar de acceso directo a la base de datos
  • Conectar agentes de LangChain o LlamaIndex con datos de BigQuery o Spanner
  • Exponer consultas a bases de datos a varios agentes mediante conjuntos de herramientas con nombre

Inicio rápido

  1. 1

    Añade el servidor Toolbox a la configuración de tu cliente MCP

  2. 2

    Ejecuta el servidor Toolbox con tu archivo de configuración

    npx @toolbox-sdk/server --config tools.yaml

Antes de usarlo

  • Para conectarte a una base de datos, debes configurar variables de entorno de conexión o un archivo de configuración.
  • La ejecución mediante npx está optimizada para ofrecer comodidad, no rendimiento; para producción, se recomiendan los binarios o los contenedores.

Temas

Preguntas frecuentes

¿Qué es mcp-toolbox?
Servidor MCP de código abierto que conecta agentes de IA, IDE y aplicaciones con bases de datos mediante herramientas predefinidas o definiciones personalizadas. MCP Toolbox for Databases es un servidor de código abierto del Model Context Protocol que permite a agentes de IA, asistentes de IDE y aplicaciones acceder a bases de datos. Ejecútalo con una opción predefinida para una base de datos determinada, como --prebuilt=postgres, y clientes MCP como Gemini CLI, Claude Code o Codex obtendrán herramientas genéricas para listar tablas, ejecutar SQL y explorar esquemas.
¿mcp-toolbox es gratuito? ¿Qué licencia tiene?
mcp-toolbox es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿mcp-toolbox sigue mantenido?
Mantenimiento activo. El último commit de mcp-toolbox fue el 17 oct 2026.
¿Para qué puedo usar mcp-toolbox?
Permitir que un asistente de programación con IA explore el esquema de PostgreSQL o MySQL y escriba código adaptado a la base de datos Proporcionar a un agente de producción unas pocas herramientas SQL parametrizadas y restringidas, en lugar de acceso directo a la base de datos Conectar agentes de LangChain o LlamaIndex con datos de BigQuery o Spanner Exponer consultas a bases de datos a varios agentes mediante conjuntos de herramientas con nombre
¿Cómo se instala mcp-toolbox?
Añade el servidor Toolbox a la configuración de tu cliente MCP Ejecuta el servidor Toolbox con tu archivo de configuración: npx @toolbox-sdk/server --config tools.yaml
¿Dónde consigo mcp-toolbox?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/googleapis/mcp-toolbox

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados