mssql-mcp

Un servidor MCP de solo lectura para Microsoft SQL Server que utiliza los detalles de conexión de AWS Secrets Manager en el momento de la llamada a la herramienta; no se lee nada del disco ni de las variables de entorno, excepto la referencia al secreto en sí.

Multiplataforma: es un servidor MCP de JavaScript puro (sin dependencias nativas ni ODBC), por lo que se ejecuta de forma idéntica en macOS, Linux y Windows a través de npx.

Configuración en .claude.json

{
 "mcpServers": {
 "my-db": {
 "command": "npx",
 "args": ["-y", "@dhipskind253/mssql-mcp"],
 "env": {
 "AWS_ACCOUNT_ID": "123456789012",
 "SECRET_NAME": "my-aws-secret",
 "AWS_REGION": "us-east-1",
 "TRUST_SERVER_CERTIFICATE": "false"
 }
 }
 }
}

Las variables de entorno estándar del SDK de AWS (AWS_PROFILE, AWS_ACCESS_KEY_ID, etc.) se respetan a través de la cadena de proveedores de credenciales predeterminada. La mayoría de los usuarios solo necesitan ejecutar aws sso login para estar al día.

Related MCP server: mssql-mcp

JSON de secreto requerido

El valor del secreto debe ser un documento JSON con al menos estos campos:

{
 "host": "myserver.database.windows.net",
 "port": 1433,
 "database": "mydb",
 "username": "ro_user",
 "password": "..."
}

database también puede proporcionarse como dbname, el nombre de campo que AWS utiliza en su plantilla de secreto de credenciales RDS integrada. Si ambos están presentes, database tiene prioridad.

Campos opcionales (se muestran los valores predeterminados):

La confianza en el certificado TLS no se lee del secreto; en su lugar, configure TRUST_SERVER_CERTIFICATE en el bloque env del servidor MCP. Cualquier campo trustServerCertificate en el JSON del secreto será ignorado.

Solo lectura por diseño

Este servidor no puede insertar, actualizar ni eliminar datos. Dos capas lo hacen cumplir:

1. La herramienta run_select rechaza léxicamente cualquier cosa que no sea una única sentencia SELECT o WITH (CTE), incluyendo INSERT, UPDATE, DELETE, EXEC, MERGE, DROP, ALTER, SELECT INTO, etc.

2. Ninguna otra herramienta emite SQL de escritura. get_procedure_definition devuelve el código fuente del procedimiento; no ejecuta procedimientos.

Nota de cortesía: trate la comprobación léxica como una mejora de UX, no como un límite de seguridad. Como cortesía hacia su yo futuro, configure las credenciales que coloque en Secrets Manager para que sean un inicio de sesión de base de datos de solo lectura, uno con solo SELECT y VIEW DEFINITION. De esa manera, una escritura accidental (o un error futuro aquí) será rechazada por el propio SQL Server.

Actualización de credenciales de AWS sin reiniciar

Debido a que el servidor utiliza la cadena de credenciales de AWS predeterminada, una sesión SSO caducada se puede recuperar sin reiniciar Claude o el servidor MCP:

1. Ejecute aws sso login en cualquier terminal.

2. Pídale a Claude que llame a la herramienta refresh_secret.

3. Continúe trabajando.

Si una llamada a la herramienta falla debido a la autenticación de AWS, el mensaje de error le indicará exactamente eso y le sugerirá el mismo flujo. Los errores están etiquetados con prefijos estables:

Herramientas

Desarrollo local

npm install
npm run build
# point your .claude.json command at the local build:
# "command": "node",
# "args": ["/absolute/path/to/mssql-mcp/dist/index.js"]

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• describe_tableA
• get_procedure_definitionA
• get_view_definitionC
• list_foreign_keysC
• list_indexesB
• list_proceduresB
• list_schemasA
• list_tablesB