siag-mcp 2.0.0

package/README.md

@@ -0,0 +1,91 @@
+# SIAG MCP Client
+
+Cliente MCP para **Claude Desktop** que conecta con el servidor centralizado SIAG en n8n.
+Soporta múltiples empresas en una sola instalación.
+
+```
+Claude Desktop  ──stdio──▶  siag-mcp-client  ──HTTPS POST──▶  n8n webhook  ──▶  SIAG API
+```
+
+---
+
+## Instalación rápida (Windows — usuarios no técnicos)
+
+1. Asegúrate de tener [Node.js 18+](https://nodejs.org) instalado
+2. Abre **PowerShell** y ejecuta:
+
+```powershell
+Set-ExecutionPolicy Bypass -Scope Process -Force
+irm https://gitlab.com/sgsst/siag-mcp-client/-/raw/main/install.ps1 | iex
+```
+
+3. El instalador te pedirá el nombre y API Key de cada empresa
+4. Reinicia Claude Desktop
+
+---
+
+## Configuración manual
+
+Edita `%APPDATA%\Claude\claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "siag": {
+      "command": "npx",
+      "args": ["-y", "@sgsst/siag-mcp"],
+      "env": {
+        "SIAG_API_KEY_EMPRESA1": "API-tu-key-empresa1",
+        "SIAG_API_KEY_EMPRESA2": "API-tu-key-empresa2"
+      }
+    }
+  }
+}
+```
+
+Reinicia Claude Desktop.
+
+---
+
+## Variables de entorno
+
+| Variable | Empresa detectada | Ejemplo |
+|---|---|---|
+| `SIAG_API_KEY` | `default` (legacy) | `SIAG_API_KEY=API-xxx` |
+| `SIAG_API_KEY_<NOMBRE>` | El nombre en minúsculas | `SIAG_API_KEY_ACME=API-yyy` → empresa `acme` |
+
+Puedes configurar una o varias empresas. Si hay más de una, Claude pedirá
+el parámetro `empresa` en cada consulta.
+
+---
+
+## Herramientas disponibles
+
+| Herramienta | Descripción | Parámetro `empresa` |
+|---|---|---|
+| `listar_empresas` | Lista las empresas configuradas | No aplica |
+| `listar_incapacidades` | Lista con filtros opcionales | Requerido si hay varias |
+| `obtener_incapacidad` | Detalle por ID | Requerido si hay varias |
+| `listar_ausentismo` | Lista con filtros opcionales | Requerido si hay varias |
+| `obtener_ausentismo` | Detalle por ID | Requerido si hay varias |
+| `verificar_conexion` | Diagnóstico de conectividad | Requerido si hay varias |
+
+---
+
+## Ejemplos de uso en Claude
+
+- *"¿Qué empresas tengo configuradas?"*
+- *"Lista las incapacidades de la empresa acme del empleado 12345678 en 2025"*
+- *"¿Cuántos días de ausentismo tuvo el área de producción en constructora este mes?"*
+- *"Muéstrame el detalle de la incapacidad con ID 450 en empresa1"*
+- *"Verifica si SIAG está respondiendo para acme"*
+
+---
+
+## Publicación
+
+```bash
+npm publish --access public
+```
+
+> Requiere cuenta en npm y haber hecho `npm login` previamente.

package/index.js

@@ -0,0 +1,317 @@
+#!/usr/bin/env node
+
+/**
+ * SIAG MCP Client
+ * ───────────────
+ * Cliente MCP para Claude Desktop que se comunica con el
+ * MCP Server centralizado en n8n (webhook /siag-mcp).
+ *
+ * Configuración en variables de entorno (o .env):
+ *   SIAG_API_KEY              → API key legacy (empresa "default")
+ *   SIAG_API_KEY_<EMPRESA>    → API key por empresa (ej: SIAG_API_KEY_ACME)
+ *   N8N_WEBHOOK_URL           → URL del webhook n8n (opcional)
+ */
+
+const fs = require("fs");
+const path = require("path");
+const { McpServer }            = require("@modelcontextprotocol/sdk/server/mcp.js");
+const { StdioServerTransport } = require("@modelcontextprotocol/sdk/server/stdio.js");
+const { z }   = require("zod");
+const axios   = require("axios");
+
+// Cargar variables de entorno manualmente desde .env sin usar console
+const envPath = path.join(__dirname, ".env");
+if (fs.existsSync(envPath)) {
+  const envContent = fs.readFileSync(envPath, "utf-8");
+  envContent.split("\n").forEach((line) => {
+    const trimmed = line.trim();
+    if (trimmed && !trimmed.startsWith("#")) {
+      const [key, ...valueParts] = trimmed.split("=");
+      if (key) process.env[key.trim()] = valueParts.join("=").trim();
+    }
+  });
+}
+
+// ─── Configuración multi-empresa ──────────────────────────────────────────────
+
+const WEBHOOK_URL = process.env.N8N_WEBHOOK_URL || "https://automate.sgsst.co/webhook/siag-mcp";
+
+/**
+ * Construye el mapa de empresas desde variables de entorno.
+ * Soporta:
+ *   SIAG_API_KEY             → empresa "default" (compatibilidad legacy)
+ *   SIAG_API_KEY_<EMPRESA>   → empresa con nombre (ej: SIAG_API_KEY_ACME → "acme")
+ */
+function buildCompanyMap() {
+  const map = {};
+  const PREFIX = "SIAG_API_KEY_";
+
+  // Legacy: clave sin sufijo
+  if (process.env.SIAG_API_KEY) {
+    map["default"] = process.env.SIAG_API_KEY;
+  }
+
+  // Prefijadas: SIAG_API_KEY_<EMPRESA>
+  for (const [key, value] of Object.entries(process.env)) {
+    if (key.startsWith(PREFIX) && value) {
+      const empresa = key.slice(PREFIX.length).toLowerCase();
+      map[empresa] = value;
+    }
+  }
+
+  return map;
+}
+
+const COMPANIES     = buildCompanyMap();
+const COMPANY_NAMES = Object.keys(COMPANIES);
+const IS_MULTI      = COMPANY_NAMES.length > 1;
+
+if (COMPANY_NAMES.length === 0) {
+  console.error(
+    "❌ ERROR: No se encontró ninguna API key de SIAG.\n" +
+    "  Configura SIAG_API_KEY o SIAG_API_KEY_<EMPRESA>=... en el entorno."
+  );
+  process.exit(1);
+}
+
+/**
+ * Resuelve la API key para la empresa indicada.
+ * - Si hay 1 sola empresa: el parámetro empresa es ignorado.
+ * - Si hay varias: empresa es obligatorio y debe coincidir.
+ */
+function resolveApiKey(empresa) {
+  if (!IS_MULTI) {
+    return { apiKey: COMPANIES[COMPANY_NAMES[0]], resolvedName: COMPANY_NAMES[0] };
+  }
+  if (!empresa) {
+    return {
+      error:
+        `Se configuraron varias empresas (${COMPANY_NAMES.join(", ")}). ` +
+        "Debes indicar el parámetro 'empresa'. Usa listar_empresas para ver las disponibles."
+    };
+  }
+  const normalized = empresa.toLowerCase();
+  const apiKey = COMPANIES[normalized];
+  if (!apiKey) {
+    return {
+      error: `Empresa '${empresa}' no encontrada. Disponibles: ${COMPANY_NAMES.join(", ")}`
+    };
+  }
+  return { apiKey, resolvedName: normalized };
+}
+
+// ─── Llamada al MCP Server (n8n) ──────────────────────────────────────────────
+
+async function callServer(apiKey, tool, params = {}) {
+  const { data } = await axios.post(
+    WEBHOOK_URL,
+    { api_key: apiKey, tool, params },
+    { headers: { "Content-Type": "application/json" }, timeout: 30000 }
+  );
+  return data;
+}
+
+function ok(text) {
+  return { content: [{ type: "text", text: typeof text === "string" ? text : JSON.stringify(text, null, 2) }] };
+}
+
+function err(msg) {
+  return { content: [{ type: "text", text: `❌ ${msg}` }], isError: true };
+}
+
+// ─── Servidor MCP ─────────────────────────────────────────────────────────────
+
+const server = new McpServer(
+  { name: "siag-client", version: "2.0.0" },
+  {
+    capabilities: { tools: {} },
+    instructions: [
+      "Cliente MCP de SIAG (SGSST) — solo lectura.",
+      "Consulta incapacidades laborales y ausentismo de personas.",
+      IS_MULTI
+        ? `Empresas configuradas: ${COMPANY_NAMES.join(", ")}. Usa el parámetro 'empresa' en cada llamada.`
+        : `Empresa activa: ${COMPANY_NAMES[0]}.`,
+      "Las llamadas se enrutan al servidor centralizado en n8n.",
+    ].join(" "),
+  }
+);
+
+// ─── Helper Zod reutilizable para el campo empresa ────────────────────────────
+
+const empresaField = IS_MULTI
+  ? z.string().describe(
+      `Nombre de la empresa a consultar. Opciones: ${COMPANY_NAMES.join(", ")}`
+    )
+  : z.string().optional().describe(
+      `Empresa (opcional — única configurada: ${COMPANY_NAMES[0]})`
+    );
+
+// ══════════════════════════════════════════════════════════════════════════════
+//  EMPRESAS
+// ══════════════════════════════════════════════════════════════════════════════
+
+server.tool(
+  "listar_empresas",
+  "Lista las empresas configuradas en este cliente SIAG MCP.",
+  {},
+  async () => {
+    const PREFIX = "SIAG_API_KEY_";
+    const list = COMPANY_NAMES.map((name) => ({
+      empresa: name,
+      variable: name === "default" ? "SIAG_API_KEY" : `${PREFIX}${name.toUpperCase()}`,
+    }));
+    return ok({ empresas: list, total: list.length });
+  }
+);
+
+// ══════════════════════════════════════════════════════════════════════════════
+//  INCAPACIDAD LABORAL
+// ══════════════════════════════════════════════════════════════════════════════
+
+server.tool(
+  "listar_incapacidades",
+  "Lista las incapacidades laborales registradas en SIAG. Todos los filtros son opcionales.",
+  {
+    empresa: empresaField,
+    documento_empleado: z.string().optional()
+      .describe("Número de documento del empleado"),
+    fecha_inicio: z.string().optional()
+      .describe("Fecha inicio del rango a consultar (YYYY-MM-DD)"),
+    fecha_fin: z.string().optional()
+      .describe("Fecha fin del rango a consultar (YYYY-MM-DD)"),
+    tipo_incapacidad: z.string().optional()
+      .describe("Tipo: enfermedad_general, accidente_trabajo, enfermedad_laboral, maternidad, paternidad"),
+    estado: z.string().optional()
+      .describe("Estado: activa, cerrada, pendiente"),
+    pagina: z.number().int().positive().optional()
+      .describe("Número de página (default: 1)"),
+    limite: z.number().int().positive().max(100).optional()
+      .describe("Registros por página (default: 20, máx: 100)"),
+  },
+  async ({ empresa, ...rest }) => {
+    const resolved = resolveApiKey(empresa);
+    if (resolved.error) return err(resolved.error);
+    try {
+      const result = await callServer(resolved.apiKey, "listar_incapacidades", rest);
+      return ok(result);
+    } catch (e) {
+      return err(`listar_incapacidades: ${e.message}`);
+    }
+  }
+);
+
+server.tool(
+  "obtener_incapacidad",
+  "Obtiene el detalle completo de una incapacidad laboral por su ID.",
+  {
+    empresa: empresaField,
+    id: z.string().describe("ID único de la incapacidad laboral"),
+  },
+  async ({ empresa, id }) => {
+    const resolved = resolveApiKey(empresa);
+    if (resolved.error) return err(resolved.error);
+    try {
+      const result = await callServer(resolved.apiKey, "obtener_incapacidad", { id });
+      return ok(result);
+    } catch (e) {
+      return err(`obtener_incapacidad [${id}]: ${e.message}`);
+    }
+  }
+);
+
+// ══════════════════════════════════════════════════════════════════════════════
+//  AUSENTISMO PERSONA
+// ══════════════════════════════════════════════════════════════════════════════
+
+server.tool(
+  "listar_ausentismo",
+  "Lista los registros de ausentismo de personas en SIAG. Todos los filtros son opcionales.",
+  {
+    empresa: empresaField,
+    documento_empleado: z.string().optional()
+      .describe("Número de documento del empleado"),
+    fecha_inicio: z.string().optional()
+      .describe("Fecha inicio del período (YYYY-MM-DD)"),
+    fecha_fin: z.string().optional()
+      .describe("Fecha fin del período (YYYY-MM-DD)"),
+    tipo_ausentismo: z.string().optional()
+      .describe("Tipo: incapacidad, calamidad, vacaciones, licencia, otro"),
+    area: z.string().optional()
+      .describe("Área o departamento"),
+    cargo: z.string().optional()
+      .describe("Cargo del empleado"),
+    pagina: z.number().int().positive().optional()
+      .describe("Número de página (default: 1)"),
+    limite: z.number().int().positive().max(100).optional()
+      .describe("Registros por página (default: 20, máx: 100)"),
+  },
+  async ({ empresa, ...rest }) => {
+    const resolved = resolveApiKey(empresa);
+    if (resolved.error) return err(resolved.error);
+    try {
+      const result = await callServer(resolved.apiKey, "listar_ausentismo", rest);
+      return ok(result);
+    } catch (e) {
+      return err(`listar_ausentismo: ${e.message}`);
+    }
+  }
+);
+
+server.tool(
+  "obtener_ausentismo",
+  "Obtiene el detalle completo de un registro de ausentismo por su ID.",
+  {
+    empresa: empresaField,
+    id: z.string().describe("ID único del registro de ausentismo"),
+  },
+  async ({ empresa, id }) => {
+    const resolved = resolveApiKey(empresa);
+    if (resolved.error) return err(resolved.error);
+    try {
+      const result = await callServer(resolved.apiKey, "obtener_ausentismo", { id });
+      return ok(result);
+    } catch (e) {
+      return err(`obtener_ausentismo [${id}]: ${e.message}`);
+    }
+  }
+);
+
+// ══════════════════════════════════════════════════════════════════════════════
+//  DIAGNÓSTICO
+// ══════════════════════════════════════════════════════════════════════════════
+
+server.tool(
+  "verificar_conexion",
+  "Verifica que la conexión con el servidor SIAG esté funcionando correctamente.",
+  {
+    empresa: empresaField,
+  },
+  async ({ empresa }) => {
+    const resolved = resolveApiKey(empresa);
+    if (resolved.error) return err(resolved.error);
+    try {
+      const result = await callServer(resolved.apiKey, "verificar_conexion");
+      return ok(result);
+    } catch (e) {
+      return err(`verificar_conexion: ${e.message}`);
+    }
+  }
+);
+
+// ─── Arranque ─────────────────────────────────────────────────────────────────
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error(
+    `[SIAG MCP] Servidor iniciado — ` +
+    (IS_MULTI
+      ? `${COMPANY_NAMES.length} empresas: ${COMPANY_NAMES.join(", ")}`
+      : `empresa: ${COMPANY_NAMES[0]}`)
+  );
+}
+
+main().catch((e) => {
+  console.error("[SIAG MCP] Error fatal:", e);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "siag-mcp",
+  "version": "2.0.0",
+  "description": "Cliente MCP de SIAG para Claude Desktop — soporte multi-empresa",
+  "main": "index.js",
+  "bin": {
+    "siag-mcp": "index.js"
+  },
+  "files": [
+    "index.js",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node index.js"
+  },
+  "keywords": [
+    "mcp",
+    "siag",
+    "sgsst",
+    "claude",
+    "ausentismo",
+    "incapacidades"
+  ],
+  "author": "SGSST <soporte@sgsst.co>",
+  "license": "ISC",
+  "engines": {
+    "node": ">=18.14.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/ANSWERCPI9999/siag-mcp-client.git"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "axios": "^1.13.6",
+    "zod": "^4.3.6"
+  }
+}