Servidor MCP para Microsoft SQL Server

Servidor MCP orientado a producción para Microsoft SQL Server, que expone operaciones de base de datos a clientes MCP (Claude Desktop, VS Code Copilot, Cursor y hosts compatibles).

Características

• Ejecución de consultas (SELECT, INSERT, UPDATE, DELETE)

• Descubrimiento de bases de datos e introspección de esquemas

• Inspección de metadatos de tablas (columnas, tipos, nulabilidad, valores predeterminados, clave primaria)

• Descubrimiento de índices y claves foráneas

• Configuración basada en variables de entorno para un despliegue seguro

Related MCP server: SQL Query Tools MCP Server

Herramientas disponibles

Requisitos

• Node.js 18+

• Acceso a una instancia de Microsoft SQL Server

• Conectividad de red desde el host MCP a SQL Server (host:puerto)

Configuración

Establezca los ajustes de conexión mediante variables de entorno:

* Obligatorio cuando MSSQL_AUTH_MODE=sql.

| MCP_TRANSPORT | No | stdio | Modo de transporte: stdio (predeterminado, para npx/Claude Desktop/VS Code) o http (HTTP Streamable, para Docker/clientes remotos como n8n) | | MCP_HTTP_PORT | No | 3001 | Puerto para el servidor HTTP (solo se usa cuando MCP_TRANSPORT=http) | | MCP_HTTP_HOST | No | 0.0.0.0 | Dirección de enlace para el servidor HTTP (solo se usa cuando MCP_TRANSPORT=http) |

Nota: la imagen Docker publicada siempre se ejecuta en modo http y no compila el controlador nativo msnodesqlv8 (usado solo para MSSQL_AUTH_MODE=windows). La autenticación de Windows solo está disponible cuando se ejecuta el servidor directamente en un host Windows mediante npx/npm start.

Uso

Ejecutar directamente desde GitHub

npx github:ferronicardoso/mcp-mssqlserver

Claude Code (CLI)

claude mcp add mssqlserver --scope user -- npx -y github:ferronicardoso/mcp-mssqlserver

--scope controla dónde se almacena el registro del servidor:

Las variables de entorno se pueden pasar con banderas repetidas --env CLAVE=VALOR antes del --, por ejemplo:

Bash (Linux/macOS/WSL):

claude mcp add mssqlserver --scope user \
  --env MSSQL_HOST=localhost \
  --env MSSQL_PORT=1433 \
  --env MSSQL_DATABASE=master \
  --env MSSQL_AUTH_MODE=sql \
  --env MSSQL_USER=sa \
  --env MSSQL_PASSWORD=your-password \
  -- npx -y github:ferronicardoso/mcp-mssqlserver

PowerShell:

claude mcp add mssqlserver --scope user `
  --env MSSQL_HOST=localhost `
  --env MSSQL_PORT=1433 `
  --env MSSQL_DATABASE=master `
  --env MSSQL_AUTH_MODE=sql `
  --env MSSQL_USER=sa `
  --env MSSQL_PASSWORD=your-password `
  -- npx -y github:ferronicardoso/mcp-mssqlserver

Codex CLI

Bash (Linux/macOS/WSL):

codex mcp add mssqlserver \
  --env MSSQL_AUTH_MODE=sql \
  --env MSSQL_HOST=localhost \
  --env MSSQL_PORT=1433 \
  --env MSSQL_DATABASE=master \
  --env MSSQL_USER=sa \
  --env MSSQL_PASSWORD=your-password \
  npx -- -y github:ferronicardoso/mcp-mssqlserver

PowerShell:

codex mcp add mssqlserver `
  --env MSSQL_AUTH_MODE=sql `
  --env MSSQL_HOST=localhost `
  --env MSSQL_PORT=1433 `
  --env MSSQL_DATABASE=master `
  --env MSSQL_USER=sa `
  --env MSSQL_PASSWORD=your-password `
  npx -- -y github:ferronicardoso/mcp-mssqlserver

Para usar autenticación de Windows en su lugar, omita MSSQL_USER/MSSQL_PASSWORD y establezca MSSQL_AUTH_MODE=windows:

Bash (Linux/macOS/WSL):

codex mcp add mssqlserver \
  --env MSSQL_AUTH_MODE=windows \
  --env MSSQL_HOST=localhost \
  --env MSSQL_PORT=1433 \
  --env MSSQL_DATABASE=master \
  npx -- -y github:ferronicardoso/mcp-mssqlserver

PowerShell:

codex mcp add mssqlserver `
  --env MSSQL_AUTH_MODE=windows `
  --env MSSQL_HOST=localhost `
  --env MSSQL_PORT=1433 `
  --env MSSQL_DATABASE=master `
  npx -- -y github:ferronicardoso/mcp-mssqlserver

Esto registra el servidor en ~/.codex/config.toml. Para eliminarlo, ejecute codex mcp remove mssqlserver.

Configuración de Claude Desktop

%APPDATA%\\Claude\\claude_desktop_config.json:

{
  "mcpServers": {
    "mssqlserver": {
      "command": "npx",
      "args": ["github:ferronicardoso/mcp-mssqlserver"],
      "env": {
        "MSSQL_HOST": "localhost",
        "MSSQL_PORT": "1433",
        "MSSQL_DATABASE": "master",
        "MSSQL_AUTH_MODE": "sql",
        "MSSQL_USER": "sa",
        "MSSQL_PASSWORD": "your-password"
      }
    }
  }
}

Configuración de MCP en VS Code

.vscode/mcp.json:

{
  "servers": {
    "mssqlserver": {
      "command": "npx",
      "args": ["github:ferronicardoso/mcp-mssqlserver"],
      "env": {
        "MSSQL_HOST": "localhost",
        "MSSQL_PORT": "1433",
        "MSSQL_DATABASE": "master",
        "MSSQL_AUTH_MODE": "sql",
        "MSSQL_USER": "sa",
        "MSSQL_PASSWORD": "your-password"
      }
    }
  }
}

Ejecutar con Docker (transporte HTTP)

La imagen publicada se ejecuta en modo HTTP Streamable de forma predeterminada, para usarse como endpoint MCP remoto (por ejemplo, desde el nodo MCP Client Tool de n8n o cualquier cliente compatible con HTTP Streamable):

Bash (Linux/macOS/WSL):

docker run -d --name mcp-mssqlserver \
  -p 3001:3001 \
  -e MSSQL_HOST=host.docker.internal \
  -e MSSQL_PORT=1433 \
  -e MSSQL_DATABASE=master \
  -e MSSQL_AUTH_MODE=sql \
  -e MSSQL_USER=sa \
  -e MSSQL_PASSWORD=your-password \
  ghcr.io/ferronicardoso/mcp-mssqlserver:latest

PowerShell:

docker run -d --name mcp-mssqlserver `
  -p 3001:3001 `
  -e MSSQL_HOST=host.docker.internal `
  -e MSSQL_PORT=1433 `
  -e MSSQL_DATABASE=master `
  -e MSSQL_AUTH_MODE=sql `
  -e MSSQL_USER=sa `
  -e MSSQL_PASSWORD=your-password `
  ghcr.io/ferronicardoso/mcp-mssqlserver:latest

El endpoint MCP estará disponible en http://localhost:3001/mcp.

Desarrollo local

git clone https://github.com/ferronicardoso/mcp-mssqlserver
cd mcp-mssqlserver
npm install
npm run build

Inicie el servidor compilado:

npm start

Flujo de compilación y confirmación

Este repositorio rastrea intencionalmente dist/ para admitir el uso de npx github:usuario/repo.

El proyecto utiliza un hook de Husky pre-commit para:

1. compilar TypeScript (npm run build)

2. preparar los artefactos generados (git add dist)

Alternativa manual:

npm run build
git add dist

Notas de seguridad

• Nunca confirme credenciales reales ni archivos .env.

• Prefiera usuarios SQL con privilegios mínimos para uso en producción.

• Para redes públicas o no confiables, habilite el cifrado (MSSQL_ENCRYPT=true) y configure los certificados adecuadamente.

Autenticación de Windows (Seguridad integrada)

Para usar autenticación de Windows con seguridad integrada (cuenta de proceso), configure:

MSSQL_AUTH_MODE=windows
MSSQL_HOST=sqlserver.company.local
MSSQL_PORT=1433
MSSQL_DATABASE=master

Licencia

MIT © Raphael Augusto Ferroni Cardoso