dsh-databases
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MSSQL_PORT | No | Puerto de la conexión por defecto. | 1433 |
| MSSQL_USER | No | Usuario de la conexión por defecto. | |
| MSSQL_ENGINE | No | Motor de la conexión por defecto: mssql | mysql | postgres. | mssql |
| MSSQL_SERVER | No | Host de la conexión por defecto. | localhost |
| MSSQL_CONFIGS | No | Archivo de conexiones declaradas. | configs/connections.json |
| MSSQL_ENCRYPT | No | TLS para SQL Server. | true |
| MSSQL_DATABASE | No | Base de datos por defecto. | master |
| MSSQL_MAX_ROWS | No | Filas por consulta (tope 5000). | 200 |
| MSSQL_PASSWORD | No | Contraseña de la conexión por defecto. | |
| MSSQL_LOG_LEVEL | No | Nivel de logs: debug | info | warn | error. | info |
| DSH_MCP_SQL_HOME | No | Dónde se guardan las conexiones creadas con save_connection. | ~/.dsh-mcp-sql |
| MSSQL_ALLOW_WRITE | No | Habilita execute_sql. | false |
| DSH_MCP_SQL_CONNECTION | No | Conexión usada cuando la herramienta no indica ninguna. | |
| MSSQL_QUERY_TIMEOUT_MS | No | Timeout de consulta en milisegundos. | 30000 |
| MSSQL_ALLOWED_DATABASES | No | Lista blanca de bases separada por comas. | |
| MSSQL_CONNECT_TIMEOUT_MS | No | Timeout de conexión en milisegundos. | 15000 |
| MSSQL_TRUST_SERVER_CERTIFICATE | No | Confiar 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
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
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.
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.
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.
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.