mcp-sqlserver

Un potente servidor Model Context Protocol (MCP) para Microsoft SQL Server. Conecta asistentes de IA (Claude, Gemini, Kiro, OpenAI, Copilot, Cursor) directamente a tus bases de datos SQL Server con controles de seguridad de nivel empresarial.

39 herramientas en 7 categorías: descubrimiento de esquemas, ejecución de consultas, DDL, procedimientos almacenados, diagnóstico de rendimiento/DBA, utilidades de desarrollo y administración del servidor.

Cambios: Consulta CHANGELOG.md para ver el historial de versiones o GitHub Releases para obtener notas detalladas de cada versión.

Novedades en v1.3

• Soporte multi-servidor — Define servidores de dev/staging/production en una sola configuración y cambia con el parámetro server

• Herramienta list_servers — Consulta todas las conexiones configuradas de un vistazo

• Seguridad por servidor — Cada servidor tiene su propio modo de seguridad, límites de filas y bases de datos bloqueadas

• Compatibilidad retroactiva — Las configuraciones existentes de un solo servidor funcionan sin ningún cambio

Related MCP server: SQL Server MCP

Novedades en v1.2

• 16 herramientas nuevas — Diagnóstico DBA, generación de código, diagramas ER, diff de esquemas, muestreo de datos y más

• Protección contra inyección SQL — Todas las consultas usan entradas parametrizadas e identificadores escapados

• Formato de fecha ISO — Las fechas se muestran como 2025-01-27 en lugar de cadenas Date de JavaScript en bruto

• Transporte HTTP streamable — Aloja el servidor MCP de forma remota con --http <puerto>

• Health check — Verifica el estado de la conexión y la capacidad de respuesta del servidor

Características

Administración del servidor (1 herramienta)

Multi-servidor: Todas las herramientas aceptan un parámetro server opcional para apuntar a un servidor con nombre concreto. Omítelo para usar el servidor predeterminado.

Descubrimiento de esquemas (9 herramientas)

Ejecución de consultas (3 herramientas)

Operaciones DDL (1 herramienta)

Procedimientos almacenados (3 herramientas)

Rendimiento y DBA (16 herramientas)

Utilidades de desarrollo (6 herramientas)

compare_schemas — Diff de esquemas

Compara dos bases de datos lado a lado. Muestra tablas, columnas y diferencias de tipo: perfecto para comparar dev vs producción.

compare_schemas(source_database: "DevDB", target_database: "ProdDB")

La salida incluye: tablas solo en el origen/destino, columnas solo en el origen/destino y diferencias de tipo/nulabilidad en las columnas.

generate_code — Generación de código

Genera código tipado a partir del esquema de cualquier tabla:

• TypeScript — interfaces con tipos adecuados (number, string, Date, Buffer | null)

• C# — clases con tipos de valor que admiten nulos (int?, DateTime?, decimal?)

• SQL — scripts CREATE TABLE con definiciones de columna completas

generate_code(table: "Products", language: "typescript")
→ export interface Products {
    productId: number;
    productName: string;
    unitPrice: number | null;
    ...
  }

generate_insert_scripts — Exportación de datos como INSERT

Genera sentencias INSERT a partir de los datos existentes de una tabla, útil para guiones de migración, datos semilla o para hacer copias de tablas de referencia pequeñas.

generate_insert_scripts(table: "Categories", top: 10)
→ INSERT INTO [dbo].[Categories] ([CategoryName], [Description]) VALUES (N'Beverages', N'Soft drinks...');

generate_er_diagram — Diagrama ER

Genera un diagrama ER en Mermaid a partir de las relaciones de claves externas. Pega la salida en cualquier renderizador compatible con Mermaid (GitHub, Notion, VS Code, etc.).

generate_er_diagram(database: "Northwind")
→ erDiagram
    Products }o--|| Categories : "CategoryID"
    Products }o--|| Suppliers : "SupplierID"
    Orders }o--|| Customers : "CustomerID"
    ...

generate_test_data — Generación de datos de prueba

Genera sentencias INSERT realistas con datos ficticios basados en los nombres y tipos de las columnas. Mejor heurística para patrones comunes (email, teléfono, nombre, ciudad, precio, etc.).

generate_test_data(table: "Customers", count: 5)
→ INSERT INTO [dbo].[Customers] (...) VALUES (N'Alice', N'user1@example.com', N'New York', ...);

sample_table — Muestreo aleatorio

Obtén una muestra aleatoria de filas de cualquier tabla con NEWID() — útil para que los asistentes de IA entiendan los patrones de datos sin recorrer las tablas enteras.

sample_table(table: "Orders", count: 5)

Seguridad

Tres modos de seguridad

Protección contra inyección SQL

Todos los valores proporcionados por el usuario se pasan como entradas de consulta parametrizadas (@param). Los identificadores de objetos (base de datos, esquema, tabla) se escapan con la notación de corchetes de SQL Server ([name] con ] → ]]).

Funciones de seguridad adicionales

• Listas de permitir/bloquar para bases de datos y esquemas

• Límites automáticos de filas (si se configura maxRowCount)

• Detección de palabras clave bloqueadas (xp_cmdshell, SHUTDOWN, DROP DATABASE, etc.)

• Enmascaramiento de datos a nivel de columna para proteger PII

• Validación del tipo de consulta según el modo de seguridad

Enmascaramiento de datos

Enmascara columnas sensibles en los resultados de las consultas:

security:
  maskColumns:
    - pattern: "*.password"
      mask: "***"
    - pattern: "*.ssn"
      mask: "XXX-XX-XXXX"
    - pattern: "dbo.users.email"
      mask: "***@***.***"

Formato del patrón: [schema.]table.column (usa * como comodín)

Autenticación

Autenticación de Windows

NTLM — Funciona de forma inmediata, sin paquetes adicionales:

connection:
  host: YOUR_SERVER\SQLEXPRESS
  authentication:
    type: windows
    user: YourUsername
    password: YourPassword
    domain: YOUR_DOMAIN
  trustServerCertificate: true

SSPI / Seguridad integrada — Usa la sesión de inicio de sesión actual de Windows:

npm install msnodesqlv8

connection:
  host: YOUR_SERVER\SQLEXPRESS
  authentication:
    type: windows
  trustServerCertificate: true

Nota: Al usar npx, las dependencias opcionales como msnodesqlv8 pueden no instalarse automáticamente. Para SSPI, considera instalar de forma global (npm install -g @tugberkgunver/mcp-sqlserver msnodesqlv8) o usa el modo NTLM.

Transporte

stdio (predeterminado)

Transporte estándar de entrada/salida, utilado por clientes MCP como Claude Desktop, VS Code, Cursor, etc.

Streamable HTTP

Para alojamiento remoto o integraciones web:

mcp-sqlserver --config mssql-mcp.yaml --http 3000

Esto inicia:

• Endpoint MCP: http://localhost:3000/mcp

• Comprobación de estado: http://localhost:3000/health → {"status":"ok","mode":"readonly"}

Incluye soporte CORS para clientes basados en navegador.

Inicio rápido

Instalación

npm install -g @tugberkgunver/mcp-sqlserver

Configuración

Crea un mssql-mcp.yaml en tu directorio de trabajo:

connection:
  host: localhost
  port: 1433
  database: MyDatabase
  authentication:
    type: sql
    user: sa
    password: YourPassword123
  trustServerCertificate: true

security:
  mode: readonly
  maxRowCount: 1000
  blockedDatabases:
    - master
    - msdb
    - tempdb
    - model

Ve config.example.yaml para conocer todas las opciones.

Configuración multi-servidor

Define varios servidores con nombre para administrar dev/la/desarrollo de dev/staging/prod desde una sola configuración:

defaultServer: dev

connections:
  dev:
    host: dev-server.example.com
    database: MyDatabase
    authentication:
      type: sql
      user: sa
      password: DevPass123
    trustServerCertificate: true
    security:
      mode: admin
      maxRowCount: 5000

  prod:
    host: prod-server.example.com
    database: MyDatabase
    authentication:
      type: sql
      user: readonly_user
      password: ProdReadOnly
    security:
      mode: readonly
      blockedDatabases: [master, msdb, tempdb, model]

# Global security defaults (applied to all servers unless overridden)
security:
  maxRowCount: 1000
  blockedKeywords: [xp_cmdshell, SHUTDOWN, DROP DATABASE]

Después usa el parámetro server en cualquier llamada de herramienta:

list_tables(server: "prod", database: "MyDatabase")
health_check(server: "dev")
compare_schemas(source_database: "DevDB", target_database: "StagingDB", server: "dev")

Configuración del cliente MCP

{
  "mcpServers": {
    "mssql": {
      "command": "npx",
      "args": ["-y", "@tugberkgunver/mcp-sqlserver"],
      "env": {
        "MSSQL_HOST": "localhost",
        "MSSQL_DATABASE": "MyDatabase",
        "MSSQL_USER": "sa",
        "MSSQL_PASSWORD": "YourPassword123"
      }
    }
  }
}

Con un archivo de configuración:

{
  "mcpServers": {
    "mssql": {
      "command": "npx",
      "args": ["-y", "@tugberkgunver/mcp-sqlserver", "--config", "/path/to/mssql-mcp.yaml"]
    }
  }
}

Añade a .vscode/mcp.json:

{
  "servers": {
    "mssql": {
      "command": "npx",
      "args": ["-y", "@tugberkgunver/mcp-sqlserver"],
      "env": {
        "MSSQL_HOST": "localhost",
        "MSSQL_DATABASE": "MyDatabase",
        "MSSQL_USER": "sa",
        "MSSQL_PASSWORD": "YourPassword123"
      }
    }
  }
}

Añade a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "mssql": {
      "command": "npx",
      "args": ["-y", "@tugberkgunver/mcp-sqlserver"],
      "env": {
        "MSSQL_HOST": "localhost",
        "MSSQL_DATABASE": "MyDatabase",
        "MSSQL_USER": "sa",
        "MSSQL_PASSWORD": "YourPassword123"
      }
    }
  }
}

Añade a .kiro/settings/mcp.json:

{
  "mcpServers": {
    "mssql": {
      "command": "npx",
      "args": ["-y", "@tugberkgunver/mcp-sqlserver"],
      "env": {
        "MSSQL_HOST": "localhost",
        "MSSQL_DATABASE": "MyDatabase",
        "MSSQL_USER": "sa",
        "MSSQL_PASSWORD": "YourPassword123"
      }
    }
  }
}

Añade a ~/.gemini/settings.json:

{
  "mcpServers": {
    "mssql": {
      "command": "npx",
      "args": ["-y", "@tugberkgunver/mcp-sqlserver"],
      "env": {
        "MSSQL_HOST": "localhost",
        "MSSQL_DATABASE": "MyDatabase",
        "MSSQL_USER": "sa",
        "MSSQL_PASSWORD": "YourPassword123"
      }
    }
  }
}

{
  "mcpServers": {
    "mssql": {
      "command": "npx",
      "args": ["-y", "@tugberkgunver/mcp-sqlserver"],
      "env": {
        "MSSQL_HOST": "localhost",
        "MSSQL_DATABASE": "MyDatabase",
        "MSSQL_USER": "sa",
        "MSSQL_PASSWORD": "YourPassword123"
      }
    }
  }
}

Añade a ~/.windsurf/mcp.json:

{
  "mcpServers": {
    "mssql": {
      "command": "npx",
      "args": ["-y", "@tugberkgunver/mcp-sqlserver"],
      "env": {
        "MSSQL_HOST": "localhost",
        "MSSQL_DATABASE": "MyDatabase",
        "MSSQL_USER": "sa",
        "MSSQL_PASSWORD": "YourPassword123"
      }
    }
  }
}

En Windows, usa cmd como envoltorio de comandos:

{
  "mcpServers": {
    "mssql": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@tugberkgunver/mcp-sqlserver", "--config", "path/to/config.yaml"]
    }
  }
}

Variables de entorno

Las variables de entorno anulan los valores del archivo de configuración.

Desarrollo

git clone https://github.com/gunvertugberk/mcp-sqlserver.git
cd mcp-sqlserver
npm install
npm run build
npm start -- --config ./mssql-mcp.yaml

Licencia

MIT