Servidor MSSQL MCP

insignia de herrería

Un servidor de Protocolo de Contexto de Modelo (MCP) para conectarse a bases de datos de Microsoft SQL Server. Este servidor proporciona herramientas para ejecutar consultas SQL y administrar conexiones a bases de datos.

Aviso de versión: Este proyecto se ha actualizado para usar el SDK del Protocolo de Contexto de Modelo 1.9.0. Consulte UPGRADE.md para obtener más información.

Instalación

Instalación mediante herrería

Para instalar MSSQL MCP Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @c0h1b4/mssql-mcp-server --client claude

Instalación manual

npm install mssql-mcp-server

Related MCP server: MySQL-MCP

Uso

Agregue el servidor a su archivo de configuración de MCP:

{
  "mcpServers": {
    "mssql": {
      "command": "mssql-mcp-server",
      "env": {
        "MSSQL_CONNECTION_STRING": "Server=localhost;Database=master;User Id=sa;Password=yourpassword;",
        // Or individual connection parameters:
        "MSSQL_HOST": "localhost",
        "MSSQL_PORT": "1433",
        "MSSQL_DATABASE": "master",
        "MSSQL_USER": "sa",
        "MSSQL_PASSWORD": "yourpassword",
        "MSSQL_ENCRYPT": "false",
        "MSSQL_TRUST_SERVER_CERTIFICATE": "true"
      }
    }
  }
}

Herramientas

consulta

Ejecutar una consulta SQL en una base de datos MSSQL.

Parámetros

connectionString (cadena, opcional): cadena de conexión completa (alternativa a parámetros individuales)
host (cadena, opcional): nombre de host del servidor de base de datos
port (número, opcional): puerto del servidor de base de datos (predeterminado: 1433)
database (cadena, opcional): nombre de la base de datos (predeterminado: master)
username (cadena, opcional): nombre de usuario de la base de datos
password (cadena, opcional): contraseña de la base de datos
query (cadena, obligatoria): consulta SQL a ejecutar
encrypt (booleano, opcional): habilitar el cifrado (predeterminado: falso)
trustServerCertificate (booleano, opcional): Certificado de servidor de confianza (valor predeterminado: verdadero)

Se debe proporcionar connectionString O ( host + username + password ).

Ejemplo

const result = await use_mcp_tool({
  server_name: 'mssql',
  tool_name: 'query',
  arguments: {
    host: 'localhost',
    username: 'sa',
    password: 'yourpassword',
    query: 'SELECT * FROM Users',
  },
});

Ejecución del servidor

Desarrollo local

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build
npm run build

# Run the built server
npm start

Usando Docker

# Build and start services (SQL Server + MCP server)
docker-compose up

# Or just build the Docker image
docker build -t mssql-mcp-server .

Pruebas

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

Seguridad

El servidor incluye protecciones contra operaciones SQL peligrosas:

Bloquea comandos potencialmente dañinos como DROP, TRUNCATE, ALTER, CREATE, EXEC, etc.
Valida todos los parámetros de entrada y nombres de bases de datos
Establece límites razonables en la longitud de la consulta y el tiempo de espera
Utiliza agrupación de conexiones para un mejor rendimiento y seguridad