Node MSSQL

Un servidor para interactuar con bases de datos de Microsoft SQL Server utilizando la librería node-mssql.

Documentación

mcp-node-mssql

Uso

Cursor

Consulta la documentación oficial de Cursor para obtener más información.

  1. Abre (o crea) el archivo mcp.json (debería estar en ~/.cursor/mcp.json o <project-root>/.cursor/mcp.json, pero consulta la documentación de Cursor para más detalles).
  2. Añade los siguientes detalles y guarda el archivo:
{
  "mcpServers": {
    "mssql": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-node-mssql"
      ],
      "env": {
        "DB_HOST": "localhost",
        "DB_PORT": "1433",
        "DB_USERNAME": "<username>",
        "DB_PASSWORD": "<password>",
        "DB_DATABASE": "<database>",
        "CONNECTION_TIMEOUT": 600000,
        "REQUEST_TIMEOUT": 300000
        "DB_ENCRYPT": "false",
        "DB_ENABLE_ARITH_ABORT": "false",
        "DB_TRUST_SERVER_CERTIFICATE": "false",
        "TRUSTED_CONNECTION": "false"
      }
    }
  }
}

Windsurf

Consulta la documentación oficial de Windsurf para obtener más información.

  1. Abre el Windsurf MCP Configuration Panel
  2. Haz clic en Add custom server.
  3. Añade los siguientes detalles y guarda el archivo:
{
  "mcpServers": {
    "mssql": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-node-mssql"
      ],
      "env": {
        "DB_HOST": "localhost",
        "DB_PORT": "1433",
        "DB_USERNAME": "<username>",
        "DB_PASSWORD": "<password>",
        "DB_DATABASE": "<database>",
        "CONNECTION_TIMEOUT": 600000,
        "REQUEST_TIMEOUT": 300000
        "DB_ENCRYPT": "false",
        "DB_ENABLE_ARITH_ABORT": "false",
        "DB_TRUST_SERVER_CERTIFICATE": "false",
        "TRUSTED_CONNECTION": "false"
      }
    }
  }
}

Claude Code

Consulta la documentación oficial de Claude Code para obtener más información.

Puedes añadir un nuevo servidor MCP desde la CLI de Claude Code. ¡Pero modificar el archivo json directamente es más sencillo!

  1. Abre el archivo de configuración de Claude Code (debería estar en ~/.claude.json).
  2. Encuentra la sección projects > mcpServers y añade los siguientes detalles y guarda el archivo:
{
  "projects": {
    "mcpServers": {
      "mssql": {
        "command": "npx",
        "args": [
          "-y",
          "mcp-node-mssql"
        ],
        "env": {
          "DB_HOST": "localhost",
          "DB_PORT": "1433",
          "DB_USERNAME": "<username>",
          "DB_PASSWORD": "<password>",
          "DB_DATABASE": "<database>",
          "CONNECTION_TIMEOUT": 600000,
          "REQUEST_TIMEOUT": 300000
          "DB_ENCRYPT": "false",
          "DB_ENABLE_ARITH_ABORT": "false",
          "DB_TRUST_SERVER_CERTIFICATE": "false",
          "TRUSTED_CONNECTION": "false"
        }
      }
    }
  }
}

Problemas y Solución de Problemas

Antes de hacer cualquier otra cosa, ¡asegúrate de que estás ejecutando la última versión!

Si encuentras problemas al usar este servidor MCP, por favor abre un issue en GitHub!

Desarrollo

Instalación

npm install

Compilación

npm run build

Ejecutar el Servidor de Desarrollo Localmente

Para probar tu versión local de desarrollo del servidor MCP en lugar de usar el paquete publicado, sigue estos pasos:

  1. Compila el proyecto:
npm run build
  1. Crea o modifica tu archivo mcp.json para que haga referencia a tu compilación local:
{
  "mcpServers": {
    "mssql": {
      "command": "node",
      "args": [
        "/path/to/your/local/mcp-node-mssql/dist/index.js"
      ],
      "env": {
        "DB_HOST": "localhost",
        "DB_PORT": "1433",
        "DB_USERNAME": "<username>",
        "DB_PASSWORD": "<password>",
        "DB_DATABASE": "<database>",
        "CONNECTION_TIMEOUT": 600000,
        "REQUEST_TIMEOUT": 300000
        "DB_ENCRYPT": "false",
        "DB_ENABLE_ARITH_ABORT": "false",
        "DB_TRUST_SERVER_CERTIFICATE": "false",
        "TRUSTED_CONNECTION": "false"
      }
    }
  }
}
  1. Coloca este archivo mcp.json en una de las siguientes ubicaciones:

    • Para Cursor: En tu directorio de inicio (~/.cursor/mcp.json) o en tu directorio de proyecto (.cursor/mcp.json)
    • Para Windsurf: Usa el Panel de Configuración de MCP para añadir el servidor personalizado
  2. Reinicia tu asistente de IA (Cursor o Windsurf) para cargar la nueva configuración.

Esto te permite probar cambios al instante en el servidor MCP sin tener que publicar una nueva versión.