de en es ja ko ru zh

Microsoft SQL Server MCP

Name: Microsoft SQL Server MCP
Author: AdrianCY

by AdrianCY

Overview Schema Related Servers Score Discussions

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 installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityInactive

ResponsivenessSyncing

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

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
QueryBear
io.github.spencerpauly
Safe, read-only Postgres and MySQL access for AI agents. Audit log + column-level controls.
Databases RAG Systems
2
Dataassist-IO
io.github.DataAssistIO
Query your org's data in natural language — read-only MCP access to SQL, NoSQL, files & warehouses.
Search Databases
2
kodey-ai-salesforce-mcp-minimal
ai.smithery
Run SOQL queries to explore and retrieve Salesforce data. Access accounts, contacts, opportunities…
Databases Customer Data Platforms ERP Systems
2

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 7 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 9 months 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)
3,338
MIT
MSSQL MCP Server
Databases Developer Tools
mihai-dulgheru
A
license
Not graded
quality
D
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 4 months ago (2026-05-11 17:17 UTC)
408
4
MIT

Appeared in Searches

Setting up SQL Server connections for agent querying

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/AdrianCY/mssql-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

@adriancy/mcp-mssql