Supports configuration through environment variables loaded from .env files, allowing customization of connection settings, security parameters, timeouts, and caching behavior.
Enables deployment of the MCP server using Docker containers, with configuration via environment variables and docker-compose for simplified setup and management.
Provides access to the repository for cloning and installation, with documentation and setup instructions accessible through GitHub.
Este es un servidor de Protocolo de Contexto de Modelo (MCP) para interacciones con SQL Server. Permite que los Modelos de Lenguaje Grandes (LLM) ejecuten consultas SQL, ejecuten procedimientos almacenados y exploren esquemas de bases de datos con mayor seguridad y robustez.
SELECT en bases de datos de SQL Server. Todas las consultas se analizan y validan para garantizar que solo se ejecuten sentencias SELECT .SELECT .SQL_ALLOWED_DATABASES para incluir en la lista blanca las bases de datos accesibles.pino integrado para registros de aplicaciones detallados y estructurados.Para obtener instrucciones completas de configuración de Docker, consulte el archivo README de Docker .
El servidor se configura mediante variables de entorno. Cree un archivo .env en el directorio raíz (puede copiar .env.example ) para configurar estos valores.
Para obtener una guía detallada sobre todas las opciones de configuración y cómo configurarlas, consulte CONFIG .
| Categoría | Variable | Descripción | Predeterminado (desde config.js) |
|---|---|---|---|
| Conexión | SQL_SERVER | Nombre de host o IP de SQL Server | localhost |
SQL_PORT | Puerto de SQL Server | 1433 | |
SQL_USER | Nombre de usuario de SQL Server | sa | |
SQL_PASSWORD | Contraseña de SQL Server | Requerido | |
SQL_DATABASE | Nombre de la base de datos predeterminada a la que conectarse | master | |
| Seguridad | SQL_ENCRYPT | Habilitar el cifrado (establecer como false para deshabilitarlo) | true |
SQL_TRUST_SERVER_CERT | Certificado de servidor de confianza (establezca como false para deshabilitarlo) | true | |
SQL_ALLOWED_DATABASES | Lista separada por comas de bases de datos a las que el servidor puede acceder. Si está vacía, el acceso es menos restringido (depende de los permisos de usuario de la base de datos). | [] (lista vacía) | |
| Tiempos de espera y reintentos | SQL_CONNECTION_TIMEOUT | Tiempo de espera de conexión (ms) | 30000 |
SQL_REQUEST_TIMEOUT | Tiempo de espera de solicitud para consultas (ms) | 30000 | |
SQL_MAX_RETRIES | Número máximo de reintentos para los intentos de conexión iniciales | 3 | |
SQL_INITIAL_RETRY_DELAY | Retraso inicial (ms) antes de volver a intentar una conexión fallida | 1000 | |
SQL_MAX_RETRY_DELAY | Retardo máximo (ms) para reintentos de conexión (usa retroceso exponencial) | 30000 | |
| Pool de conexiones | SQL_POOL_MAX | Máximo de conexiones en el pool | 10 |
SQL_POOL_MIN | Conexiones mínimas en el pool | 0 | |
SQL_POOL_IDLE_TIMEOUT | Tiempo de espera inactivo para conexiones en el grupo (ms) | 30000 | |
| Almacenamiento en caché | SQL_SCHEMA_CACHE_TTL | Tiempo de vida para la caché de esquema (ms) | 300000 (5 minutos) |
| Servidor MCP | MCP_SERVER_NAME | Nombre del servidor MCP | MSSQL Server |
MCP_SERVER_VERSION | Versión del servidor MCP | 1.0.0 | |
| Explotación florestal | LOG_LEVEL | Nivel de registro del registrador Pino (p. ej., fatal , error , warn , info , debug , trace , silent ). Se lee directamente desde process.env en server.ts , no forma parte de config.js . | info |
Para agregar este servidor MCP a Claude CLI:
En la conversación de Claude, puedes:
SELECT :database es opcional si se opera en SQL_DATABASE predeterminado o si SQL_ALLOWED_DATABASES implica una única elección).YourDatabaseName , el valor predeterminado es SQL_DATABASE especificado en las variables de entorno).Este servidor MCP utiliza un grupo de conexiones global y robusto (agrupación integrada de la biblioteca mssql ) administrado por DatabaseService .
execute_query independientes) desde el LLM utilicen exactamente la misma conexión de base de datos subyacente. Por lo tanto, el estado específico de la sesión, como las tablas temporales o las variables de sesión creadas en una llamada, podría no estar disponible en otra. Cada llamada debe considerarse atómica desde la perspectiva del estado de la sesión. El comando USE [database] se ejecuta en cada operación si la base de datos de destino difiere de la predeterminada del pool, lo que garantiza el contexto para esa operación específica.SELECT : El servidor exige estrictamente que solo se puedan ejecutar consultas SELECT mediante la herramienta execute_query , mediante análisis SQL. Las instrucciones DML (INSERT, UPDATE, DELETE) y DDL están bloqueadas.SQL_ALLOWED_DATABASES para restringir las bases de datos con las que el servidor puede interactuar. Para obtener una explicación detallada de esta función y cómo interactúa con SQL_DATABASE , consulte DATABASE_WHITELISTING.md .sp_ , xp_ ) y comandos como RECONFIGURE o WAITFOR DELAY mediante execute_query . Se deben utilizar procedimientos almacenados para interacciones legítimas con el sistema.mssql , que normalmente los parametriza para evitar la inyección de SQL.Si encuentra problemas:
docker logs mssql-mcp (si usa Docker)..env estén configuradas correctamente, especialmente SQL_PASSWORD , SQL_SERVER , SQL_USER y SQL_DATABASE .SQL_ALLOWED_DATABASES si ha configurado esta variable.test-mcp.sh , test-session-persistence.sh ) necesiten revisión o actualizaciones.Para obtener una solución detallada de problemas de Docker, consulte el archivo README de Docker .
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Un servidor de protocolo de contexto de modelo que permite que los modelos de lenguaje grandes como Claude ejecuten consultas SQL, exploren esquemas de bases de datos y mantengan conexiones persistentes a bases de datos de SQL Server.