hs-sql-agent

Despliega fácilmente un servidor HTTP MCP para bases de datos relacionales con un panel de administración integrado. hs-sql-agent permite que clientes MCP como Claude Desktop, Cursor y Visual Studio Code accedan de forma segura a bases de datos relacionales, mientras los administradores gestionan de forma centralizada las conexiones, claves MCP, permisos, registros de auditoría y políticas de seguridad. Esta plantilla de Zeabur despliega automáticamente:

• hs-sql-agent — servidor MCP y panel de administración
• PostgreSQL — base de datos interna de administración
• Redis — caché, limitación de solicitudes, control de concurrencia y sincronización de políticas de seguridad

✨ Funciones principales

• 🔌 Endpoint HTTP MCP
• 🔑 Claves de acceso MCP independientes por cliente
• 🗄️ Gestión de múltiples conexiones de base de datos
• 🔐 Asociación de una base de datos por clave MCP
• 🧰 Permisos de herramientas MCP configurables por clave
• 🚦 Límites de solicitudes configurables
• 📋 Registros de auditoría de ejecución SQL
• 🛡️ Políticas de seguridad centralizadas
• ⚡ Caché y control de concurrencia mediante Redis
• 🖥️ Panel de administración web integrado
• 📋 Configuraciones de cliente MCP listas para copiar

🚀 Primeros pasos

1. Desplegar la plantilla

Despliega esta plantilla en Zeabur y configura un subdominio para el panel de administración. Zeabur creará y conectará automáticamente todos los servicios necesarios. Cuando finalice el despliegue, abre la Admin Panel URL que aparece en las instrucciones del despliegue de Zeabur.

2. Crear la cuenta de administrador

En el primer inicio, deberás crear la primera cuenta de administrador. Después, inicia sesión en el panel de administración con esa cuenta.

3. Añadir una base de datos

Abre DB Management y añade la base de datos relacional a la que quieres permitir acceso desde los clientes MCP. Se recomienda probar la conexión antes de emitir una clave MCP.

4. Emitir una clave de acceso MCP

Abre: Runtime Admin → MCP Keys Crea una nueva clave MCP y configura sus permisos de acceso. Las opciones configurables incluyen:

• Nombre de la clave
• Fecha de expiración
• Base de datos
• Rate Limit
• Herramientas MCP permitidas
• Restricciones opcionales de acceso a datos
• CORS Origins opcionales Haz clic en Test DB Connection para verificar la conexión con la base de datos seleccionada y, a continuación, en Issue Key.

5. Copiar la configuración MCP

Después de emitir la clave, hs-sql-agent mostrará inmediatamente el cuadro de diálogo Save and connect. Este incluye:

• La clave MCP, visible una sola vez
• El MCP Endpoint
• La configuración completa ya generada para clientes MCP compatibles Selecciona el cliente que utilizas:
• Claude Desktop
• Cursor
• Visual Studio Code
• Generic HTTP Después, haz clic en el botón Copy config correspondiente y pega directamente la configuración en tu cliente MCP.

⚠️ El valor en texto plano de la clave MCP solo se muestra una vez. > > Guarda la clave o copia la configuración generada antes de cerrar el cuadro de diálogo. Una vez cerrado, el valor en texto plano de la clave no podrá volver a consultarse desde la Admin UI. Eso es todo. No es necesario configurar manualmente el MCP Endpoint ni el header de autenticación.

🔐 Seguridad

Trata las claves MCP como información sensible, igual que una contraseña. No envíes configuraciones que contengan claves MCP a repositorios de código fuente, Issues públicos, tickets ni otros lugares públicos. Si una clave queda expuesta, revócala desde la página MCP Keys y emite una nueva. Para bases de datos de producción, se recomienda utilizar cuentas de base de datos dedicadas y aplicar el principio de mínimo privilegio, concediendo únicamente los permisos necesarios para las herramientas MCP utilizadas.

⚠️ Estado del proyecto

hs-sql-agent se encuentra actualmente en desarrollo activo. Las funciones y opciones de configuración pueden cambiar entre versiones y todavía pueden existir errores. Si encuentras un problema o quieres solicitar una función:

• 🔗 GitHub Issues
• ⭐ GitHub Repository