de en es ja ko ru zh

Microsoft SQL Server MCP

Name: Microsoft SQL Server MCP
Author: AdrianCY

by AdrianCY

Overview Schema Source Related Servers Discussions Admin

TypeScript

`@adriancy/mcp-mssql`

Servidor MCP (stdio) para Microsoft SQL Server. Expone herramientas para que Cursor (o cualquier cliente MCP) pueda listar tablas, describir columnas y ejecutar T-SQL con preferencia de lectura.

Úsalo en Cursor

Abre Cursor Settings → MCP (o edita tu JSON de MCP).
Añade un bloque de servidor. Configura env para tu base de datos (consulta .env.example).

Desde npm (después de que el paquete sea publicado):

{
  "mcpServers": {
    "mssql": {
      "command": "npx",
      "args": ["-y", "@adriancy/mcp-mssql"],
      "env": {
        "MSSQL_SERVER": "localhost",
        "MSSQL_USER": "your_user",
        "MSSQL_PASSWORD": "your_password",
        "MSSQL_DATABASE": "your_database",
        "MSSQL_TRUST_SERVER_CERTIFICATE": "true"
      }
    }
  }
}

Desde un clon local (ejecuta pnpm install && pnpm build primero):

{
  "mcpServers": {
    "mssql": {
      "command": "node",
      "args": ["/absolute/path/to/mssql-mcp/dist/index.js"],
      "env": {
        "MSSQL_SERVER": "localhost",
        "MSSQL_USER": "your_user",
        "MSSQL_PASSWORD": "your_password",
        "MSSQL_DATABASE": "your_database",
        "MSSQL_TRUST_SERVER_CERTIFICATE": "true"
      }
    }
  }
}

Usa node para archivos locales. Evita pnpm como command de MCP: la salida adicional en stdout puede romper el protocolo.

Confirma que el nombre de instalación coincida con npm: npm view @adriancy/mcp-mssql version.

Related MCP server: MSSQL Database MCP Server

Entorno

Todas las variables se leen desde el entorno del proceso MCP (ej. env de Cursor). Los booleanos tratan 1, true, yes, on (sin distinguir mayúsculas/minúsculas) como verdadero y 0, false, no, off como falso. Los valores booleanos y enteros no válidos provocan un error en la validación de inicio.

Variable	Requerido	Predeterminado	Significado
`MSSQL_SERVER`	sí	—	Nombre de host o IP de SQL Server
`MSSQL_USER`	sí†	—	Usuario de inicio de sesión (autenticación SQL, NTLM, contraseña de Azure AD); no se usa para `azure-active-directory-access-token` o flujos exclusivos de entidad de servicio
`MSSQL_PASSWORD`	sí*†	—	Contraseña de inicio de sesión (*puede estar vacía para algunas configuraciones)
`MSSQL_DATABASE`	sí	—	Base de datos inicial
`MSSQL_PORT`	no	`1433`	Puerto TCP; omitir al usar `MSSQL_INSTANCE_NAME` (el controlador usa la instancia + SQL Browser)
`MSSQL_ENCRYPT`	no	`true`	TLS `encrypt`: `true`, `false` o `strict` (TDS 8.0 / tedious)
`MSSQL_TRUST_SERVER_CERTIFICATE`	no	`false`	Confiar en certificados autofirmados / omitir validación de certificado (solo desarrollo)
`MSSQL_TLS_SERVER_NAME`	no	—	Nombre de host para validación TLS cuando difiere de `MSSQL_SERVER` (ej. conectar por IP)
`MSSQL_TLS_CA_FILE`	no	—	Ruta al PEM de CA; pasado a través de `cryptoCredentialsDetails.ca`
`MSSQL_TLS_CERT_FILE`	no	—	PEM de certificado de cliente opcional (TLS mutuo)
`MSSQL_TLS_KEY_FILE`	no	—	PEM de clave privada de cliente opcional
`MSSQL_TLS_KEY_PASSPHRASE`	no	—	Frase de contraseña para clave de cliente cifrada
`MSSQL_CONNECTION_TIMEOUT_MS`	no	(predeterminado del controlador)	`connectionTimeout` del pool (ms). `0` → sin establecer
`MSSQL_DOMAIN`	no	—	Inicio de sesión de dominio (`config.domain` para autenticación SQL; requerido para `MSSQL_AUTH_TYPE=ntlm`)
`MSSQL_INSTANCE_NAME`	no	—	Instancia con nombre (`options.instanceName`); no depender de `MSSQL_PORT` con esto configurado
`MSSQL_MULTI_SUBNET_FAILOVER`	no	`false`	Sugerencia de conmutación por error estilo grupo de disponibilidad
`MSSQL_READ_ONLY_INTENT`	no	`false`	Enrutamiento de solo lectura para secundarios de AG
`MSSQL_MAX_RETRIES_ON_TRANSIENT_ERRORS`	no	—	`maxRetriesOnTransientErrors` de Tedious; `0` → sin establecer
`MSSQL_CONNECTION_RETRY_INTERVAL_MS`	no	—	`connectionRetryInterval` de Tedious; `0` → sin establecer
`MSSQL_POOL_MAX`	no	`10`	Conexiones máximas del pool
`MSSQL_POOL_MIN`	no	`0`	Conexiones mínimas del pool
`MSSQL_POOL_IDLE_TIMEOUT_MS`	no	`30000`	`pool.idleTimeoutMillis`
`MSSQL_APP_NAME`	no	—	`options.appName` (seguimiento del servidor)
`MSSQL_USE_UTC`	no	`true`	`options.useUTC` cuando está configurado
`MSSQL_TDS_VERSION`	no	—	`7_1`, `7_2`, `7_3_A`, `7_3_B` o `7_4`
`MSSQL_AUTH_TYPE`	no	—	`ntlm`, `azure-active-directory-password`, `azure-active-directory-access-token`, `azure-active-directory-service-principal-secret`, o sin establecer/`default` para inicio de sesión SQL
`MSSQL_AZURE_CLIENT_ID`	no‡	—	ID de aplicación (cliente) de Azure AD donde sea necesario
`MSSQL_AZURE_TENANT_ID`	no‡	—	ID de inquilino (opcional para autenticación por contraseña, predeterminado `common`; requerido para entidad de servicio)
`MSSQL_AZURE_CLIENT_SECRET`	no‡	—	Secreto de entidad de servicio
`MSSQL_AZURE_ACCESS_TOKEN`	no‡	—	Token pre-obtenido para autenticación por token de acceso
`MSSQL_ALLOW_WRITES`	no	`false`	Si es falso/no establecido, bloquea patrones comunes de escritura/DDL/exec en `mssql_query` (solo heurístico)
`MSSQL_QUERY_TIMEOUT_MS`	no	(predeterminado del controlador)	Tiempo de espera de solicitud en ms para el controlador. `0` → sin establecer

† Requerido para autenticación SQL y para tipos de autenticación que usan inicio de sesión de usuario interactivo. ‡ Requerido dependiendo de MSSQL_AUTH_TYPE; consulta .env.example. NTLM en Node 17+ puede necesitar --openssl-legacy-provider (consulta las preguntas frecuentes de tedious).

Consulta también .env.example.

Herramientas

Herramienta	Propósito
`mssql_query`	Ejecutar T-SQL; devuelve filas y `rowsAffected`
`mssql_list_tables`	Tablas en `INFORMATION_SCHEMA`
`mssql_describe_table`	Metadatos de columna

Cuando MSSQL_ALLOW_WRITES no está establecido/es falso, los patrones obvios de escritura/DDL se bloquean (solo heurístico; usa permisos de base de datos para una seguridad real).

Desarrollo

pnpm install
pnpm check
pnpm test
pnpm build && pnpm start
pnpm dev

Usa pnpm format para aplicar correcciones de formato de Biome y pnpm lint para ejecutar reglas de lint sin formatear.

Usa un inicio de sesión SQL de solo lectura o de privilegios mínimos para el uso diario.

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityInactive

ResponsivenessSyncing

Resources

Related MCP Connectors

GoSQLX A
io.github.ajitpratap0
SQL validation, formatting, parsing, metadata extraction, linting, and security analysis.
Databases Code Analysis Developer Tools
71120
https://mcp.gosqlx.dev/mcp
wgong-sqlite-mcp-server
ai.smithery
Explore, query, and inspect SQLite databases with ease. List tables, preview results, and view det…
Databases Developer Tools
21
https://server.smithery.ai/@wgong/sqlite-mcp-server/mcp
SaturnSQL A
com.saturnsql
Query Postgres, MySQL, SQL Server, Oracle, BigQuery, ClickHouse and Redshift from your AI client.
Databases
111
https://mcp.saturnsql.com/mcp
Draxlr AOAuth
com.draxlr.api
Draxlr's remote MCP server connects AI assistants to your SQL databases and dashboards. Explore schemas, run read-only queries, manage saved queries and dashboards, and export results, all with row-level security so each user sees only their own data.
Data Visualization Databases Search
1
https://api.draxlr.com/mcp

Related MCP Servers

SQL Server MCP
Databases Developer Tools
bpamiri
A
license
A
quality
C
maintenance
Enables AI assistants to interact with Microsoft SQL Server databases through query execution, schema discovery, CRUD operations, stored procedures, and data export with built-in safety controls.
Updated 9 months ago (2026-02-09 19:32 UTC)
18
Apache 2.0
MSSQL Database MCP Server
Databases Developer Tools
vpro1032
A
license
Not graded
quality
D
maintenance
Enables AI assistants to securely interact with Microsoft SQL Server databases to query data, inspect schemas, and retrieve metadata with read-only operations by default and optional write capabilities.
Updated a year ago (2025-12-07 22:22 UTC)
1
MIT
MCP SQL Server
Databases Developer Tools
steevenmentech
A
license
Not graded
quality
D
maintenance
Enables interaction with Microsoft SQL Server databases using both SQL Server and Windows Authentication. It supports flexible connection configurations, including read-only modes and encrypted communication for secure data management.
Updated a year ago (2025-08-06 19:09 UTC)
2,491 npm
MIT
MSSQL MCP Server
Databases Developer Tools
mihai-dulgheru
A
license
Not graded
quality
A
maintenance
Enables AI assistants to interact with Microsoft SQL Server databases via introspection and query tools. Supports single or multiple databases with read-only mode by default and an optional write capability.
Updated 2 months ago (2026-09-11 18:16 UTC)
629 npm
5
MIT

Appeared in Searches

Setting up SQL Server connections for agent querying

@adriancy/mcp-mssql