Skip to main content
Glama
dsh-databases

dsh-databases

by nvznc

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MSSQL_PORTNoPuerto de la conexión por defecto.1433
MSSQL_USERNoUsuario de la conexión por defecto.
MSSQL_ENGINENoMotor de la conexión por defecto: mssql | mysql | postgres.mssql
MSSQL_SERVERNoHost de la conexión por defecto.localhost
MSSQL_CONFIGSNoArchivo de conexiones declaradas.configs/connections.json
MSSQL_ENCRYPTNoTLS para SQL Server.true
MSSQL_DATABASENoBase de datos por defecto.master
MSSQL_MAX_ROWSNoFilas por consulta (tope 5000).200
MSSQL_PASSWORDNoContraseña de la conexión por defecto.
MSSQL_LOG_LEVELNoNivel de logs: debug | info | warn | error.info
DSH_MCP_SQL_HOMENoDónde se guardan las conexiones creadas con save_connection.~/.dsh-mcp-sql
MSSQL_ALLOW_WRITENoHabilita execute_sql.false
DSH_MCP_SQL_CONNECTIONNoConexión usada cuando la herramienta no indica ninguna.
MSSQL_QUERY_TIMEOUT_MSNoTimeout de consulta en milisegundos.30000
MSSQL_ALLOWED_DATABASESNoLista blanca de bases separada por comas.
MSSQL_CONNECT_TIMEOUT_MSNoTimeout de conexión en milisegundos.15000
MSSQL_TRUST_SERVER_CERTIFICATENoConfiar en el certificado del servidor para SQL Server.true

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Servidor MCP para SQL Server, MySQL/MariaDB y PostgreSQL. Empieza con list_connections para ver qué conexiones existen y su motor; elige una con el parámetro "connection". Explora con list_databases, list_tables y describe_table antes de ejecutar run_query (solo lectura, filas acotadas por maxRows). Nunca inventes credenciales: si falta una conexión, pide los datos al usuario y guárdala con save_connection.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_connectionsA

Muestra los motores soportados (mssql, mysql, postgres) y las conexiones configuradas: la del .env ("default"), las declaradas en configs/connections.json y las guardadas con save_connection. Usa los nombres que devuelve en el parámetro "connection" del resto de herramientas.

save_connectionA

Guarda (o reemplaza) una conexión con nombre en el archivo de datos del usuario, para luego elegirla con "connection" en list_databases, list_tables, describe_table, run_query y execute_sql. No valida la conexión; usa test_connection después de guardar.

remove_connectionA

Elimina una conexión creada con save_connection. No afecta a las del .env ni a configs/connections.json.

test_connectionA

Abre una conexión y devuelve la información real del servidor (versión, host, usuario) o el error exacto. Úsala después de editar configs/connections.json o de guardar una conexión.

list_databasesA

Lista las bases de datos a las que tiene acceso la conexión elegida (mssql, mysql o postgres), con estado y tamaño cuando el motor lo expone. Úsala para descubrir qué bases existen antes de consultar tablas.

list_tablesA

Lista tablas y/o vistas de la base elegida, filtradas por esquema o por texto en el nombre. Devuelve esquema, nombre, tipo, filas aproximadas y fechas cuando el motor las expone. Es el primer paso para explorar un esquema desconocido en cualquier motor.

describe_tableA

Devuelve el esquema detallado de una tabla o vista: columnas con tipo, nulabilidad, valor por defecto, auto-incremento/identidad, índices y claves foráneas. Úsala antes de escribir consultas.

run_queryA

Ejecuta una única sentencia de lectura (SELECT/WITH; en mysql/postgres también EXPLAIN, SHOW o DESCRIBE) y devuelve las filas como JSON. No permite escribir ni varias sentencias. Las filas se limitan a 200 por defecto (máximo 5000). Usa list_tables y describe_table para explorar.

server_infoA

Muestra versión, host, usuario actual y fecha de arranque del servidor de la conexión elegida. Sirve para confirmar a qué servidor y motor se está conectando el MCP.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.8/5.0

Scored across 9 tools

Disambiguation4/5

Most tools have clear, distinct purposes split across connection management, discovery, and querying. The main overlap is between test_connection and server_info, which both return version/host/user for the selected connection, making it easy to pick the wrong one for diagnostics.

Naming Consistency4/5

Nearly all names follow a predictable snake_case verb_noun pattern (list_connections, save_connection, list_tables, describe_table, run_query). The only deviation is the noun-only server_info, which is a minor break in the convention.

Tool Count5/5

Nine tools is well within the sweet spot and each one covers a distinct facet of database exploration and connection management. Nothing feels bloated or missing at the count level.

Completeness2/5

The surface is read-only: run_query explicitly forbids writes and there is no execute_sql tool, yet save_connection's description tells agents to use execute_sql, a dead reference that will cause failures. For a multi-engine database server, missing any DML/DDL path is a significant lifecycle gap.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues