MCP SQL Server Connector

Servidor MCP que expone tu base de datos SQL Server a Claude para hacer consultas en lenguaje natural.

Herramientas expuestas

• list_tables — lista tablas y vistas disponibles.
• describe_table — columnas y tipos de una tabla.
• run_query — ejecuta un SELECT (bloquea cualquier otra operación).

1. Configurar variables de entorno

cp .env.example .env

Edita .env con los datos reales de tu conexión (los mismos que ves en tu cliente de SQL Server) y genera un token de autenticación:

openssl rand -hex 32

Pega ese valor en MCP_AUTH_TOKEN.

2. Instalar y correr localmente (para probar antes de subir a AWS)

npm install
npm start

Deberías ver:

[server] MCP SQL Server connector escuchando en puerto 3000
[db] Conectado a SQL Server: <tu-host> / <tu-base>

Prueba rápida:

curl http://localhost:3000/health

3. Notas de seguridad (pendientes, en orden de prioridad)

1. Usuario de solo lectura — hoy el .env usa tu usuario personal (lvillanueva). Antes de dar acceso al equipo, hay que crear un login dedicado con permisos SELECT únicamente. Lo hacemos en el siguiente paso.
2. Apuntar a la base real, no a master — cambia DB_DATABASE en el .env cuando sepamos el nombre de la base de negocio.
3. Vistas para columnas sensibles — si hay datos como sueldos o PII, conviene exponer vistas que ya las excluyan.

Próximo paso

Desplegar esto en AWS. Opciones evaluadas por costo: ver conversación con Claude para la recomendación específica según tu tráfico esperado.