Production Plan Variance MCP Server

Un pequeño servidor MCP que expone el panel Production Plan Variance & Issue Tracking (erp.peopledesk.io/production-management/mes/ProductionPlanVariance) como cinco herramientas de solo lectura, respaldado directamente por la base de datos DWH:

Consulta estas tablas DWH (verificadas contra el esquema en vivo): tblProductionPlanVarianceIssueArc, tblProductionPlanVarianceReasonArc, tblPlantArc, tblShopFloorArc.

Por qué esta estructura

Pediste algo que cualquiera pueda usar mediante un archivo JSON, sin que nadie tenga que introducir credenciales de base de datos. Por eso el diseño es:

• Un solo servidor, alojado por ti, que guarda las credenciales de la base de datos en sus propias variables de entorno (.env, nunca confirmado en el repositorio, nunca enviado a los clientes).

• Todos los demás solo colocan mcp-config.json en su cliente MCP (Claude Desktop, Claude Code, etc.) — solo contiene una URL, nada secreto. El servidor es el único que se comunica con SQL Server.

• Todas las consultas son SELECT fijos y parametrizados definidos en src/queries.js — no se expone ninguna herramienta SQL de formato libre, por lo que nadie que use este servidor MCP puede consultar fuera de los datos propios del panel ni ejecutar escrituras.

⚠️ Antes de desplegar: confirma los permisos de la base de datos

Mientras construía esto, verifiqué el esquema (tablas/columnas) usando tu conexión mssql-test-server, pero cada SELECT real a nivel de fila contra tblProductionPlanVarianceIssueArc / tblPlantArc etc. falló — la introspección del esquema funcionó, las consultas de datos no. Eso casi con seguridad es una brecha de permisos en ese inicio de sesión SQL específico (mcp_user), no un problema con estas consultas. Antes de pasar a producción:

1. Crea (o reutiliza) un inicio de sesión de SQL Server con permisos de solo SELECT en las tablas DWH enumeradas arriba.

2. Prueba manualmente, por ejemplo:

   SELECT TOP 5 * FROM dbo.tblProductionPlanVarianceIssueArc;

3. Solo entonces apunta DB_USER/DB_PASSWORD en .env a ese inicio de sesión.

Despliegue

Opción A — tu propio servidor (nginx/Caddy delante)

npm install
cp .env.example .env    # fill in DB_SERVER / DB_USER / DB_PASSWORD
npm start                # listens on :3300, endpoint POST /mcp

Ponlo detrás de HTTPS en un dominio accesible para tu equipo, p. ej. https://mcp.yourcompany.com/mcp.

Opción B — Vercel (ya configurado en este repositorio)

Los archivos api/mcp.js + vercel.json convierten el mismo servidor en una función serverless de Vercel, expuesta en /mcp.

1. Sube esta carpeta a un repositorio de GitHub (o ejecútala directamente desde la carpeta).

2. Instala la CLI una vez: npm i -g vercel

3. Desde dentro de production-variance-mcp/, inicia sesión en tu propia cuenta de Vercel y despliega:

   vercel login
   vercel --prod

4. En el panel de Vercel → tu proyecto → Configuración → Variables de entorno, añade DB_SERVER, DB_PORT, DB_DATABASE, DB_USER, DB_PASSWORD, DB_ENCRYPT, DB_TRUST_CERT (los mismos valores que en .env.example), y luego vuelve a desplegar para que la función los recoja.

5. Tu endpoint MCP ahora es https://<your-project>.vercel.app/mcp. Pon esa URL en mcp-config.json y compártelo.

Nota: SQL Server debe ser accesible desde la red de Vercel (es decir, no estar restringido por firewall solo a la IP de tu oficina) — consulta con quien administra 203.202.241.211 si la conexión agota el tiempo de espera después de desplegar. Añade también algún tipo de autenticación delante de /mcp (ver nota más abajo) antes de que esta URL sea pública — ahora mismo cualquiera con el enlace puede llamar a estas herramientas de solo lectura.

Distribución

Edita mcp-config.json, reemplazando YOUR-HOSTED-DOMAIN con tu dominio real, y comparte ese único archivo. Cualquiera lo añade a su cliente MCP y de inmediato tiene acceso de solo lectura por chat a los datos de este panel — sin instalación, sin credenciales, sin conocimientos de SQL.

Notas / cosas que debes verificar por tu cuenta

• La columna "Máquina" del panel (p. ej. "Aromatic Unit Line - 01") no se encontró en tblProductionPlanVarianceIssueArc en el esquema que obtuve — probablemente se resuelve mediante una tabla de línea de producción / centro de trabajo en tu entorno. La consulta de list_plan_variance aún no la incluye; añade el JOIN apropiado en src/queries.js una vez que confirmes la tabla de origen (candidatas: tblProductionLineArc, tblWorkCenterArc).

• La lógica de "Incidencias faltantes" de get_variance_summary asume que significa "variación marcada sin motivo/estado registrado todavía" — confírmalo contra la lógica de negocio real de la aplicación y ajusta QUERY_SUMMARY si es diferente.

• Añade autenticación (clave de API / OAuth) delante de /mcp antes de exponerlo más allá de tu red interna — esta versión no tiene ninguna por defecto.