# 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

```bash
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:

```bash
openssl rand -hex 32
```

Pega ese valor en `MCP_AUTH_TOKEN`.

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

```bash
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:
```bash
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.