@koggitechorg/koggi-mcp-server 1.0.10 → 1.0.12

package/README.md

@@ -11,12 +11,24 @@ Una herramienta (MCP server) ligera para exponer un comando/tool llamado `genera
 
 ## Características
 
-- Tool MCP: `generate_simulator`
-	- Propósito: Generar un simulador financiero para un usuario dado.
-	- Schema (Zod): `identification`, `origen_identification`,`builder`,`email_requester`, `income_updated`, `observations` (todos son obligatorios `index.ts`).
-- Comunicación: stdin/stdout (StdioServerTransport) siguiendo el SDK `@modelcontextprotocol/sdk`.
-- Cliente HTTP: usa `node-fetch` y `EXTERNAL_URL` como base para las peticiones.
-
+ * ## Características
+ 
+  - Tool MCP: `get_info_calculators`
+    - Propósito: Obtener la información de los calculadores asignados a una lista de identificaciones.
+   - Schema (Zod): `identifications` (array de números), `entityKey` (string) — ambos obligatorios.
+ 
+  - Tool MCP: `assign_and_get_last_calculator`
+    - Propósito: Asignar y obtener el último calculador asociado a un número de identificación específico.
+    - Schema (Zod): `identification` (number), `entityKey` (string) — ambos obligatorios.
+ 
+  - Tool MCP: `generate_simulator`
+    - Propósito: Generar un simulador financiero para un usuario dado.
+    - Schema (Zod): `identification`, `origen_identification`, `builder`, `email_requester`,
+      `income_updated`, `observations` (todos son obligatorios — definidos en `index.ts`).
+ 
+  - Comunicación: stdin/stdout (StdioServerTransport) siguiendo el SDK `@modelcontextprotocol/sdk`.
+  - Cliente HTTP: usa `node-fetch` y la variable de entorno `EXTERNAL_URL` como base para las peticiones.
+ 
 ## Requisitos
 
 - Node.js 18+ (o compatible con ESM y fetch nativo).

package/dist/handlers/calculator.js

@@ -0,0 +1,9 @@
+import { validateRequestToken } from "../middlewares/middleware.js";
+import { apiFetch } from "../utils/apiClient.js";
+async function assign_and_get_last_calculator(data) {
+    return await validateRequestToken(async () => apiFetch(`/api/monitoreo-financiero/last-calculator-by-identification-for-builder`, {
+        method: "POST",
+        body: JSON.stringify(data),
+    }));
+}
+export { assign_and_get_last_calculator, };

package/dist/handlers/hdc.js

@@ -0,0 +1,9 @@
+import { validateRequestToken } from "../middlewares/middleware.js";
+import { apiFetch } from "../utils/apiClient.js";
+async function getHdcByIdLead(idLead) {
+    return await validateRequestToken(async () => apiFetch(`/api/monitoreo-financiero/get-hdc-by-lead`, {
+        method: "POST",
+        body: JSON.stringify({ idLead }),
+    }));
+}
+export { getHdcByIdLead };

package/dist/index.js

@@ -4,26 +4,115 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { z } from "zod";
 import { generateSimulator } from "./handlers/simulator.js";
 import { errorHandler } from "./error/error.handler.js";
-// Create an MCP server
+import { assign_and_get_last_calculator } from "./handlers/calculator.js";
+import { getHdcByIdLead } from "./handlers/hdc.js";
+// Crear el servidor MCP
 const server = new McpServer({
     name: "koggi-mcp-server",
-    version: "1.0.10",
-    description: "Custom MCP server for Koggi",
+    version: "1.0.11",
+    description: "Servidor MCP personalizado para Koggi",
 });
-server.tool("generate_simulator", "Genera un simulador financiero para un usuario usando su número de documento. Campos requeridos: \
-  identification (string, número de documento del cliente o número del lead), \
-  origen_identification (string, origen de la identificación del lead puede tener dos valores 'input' o 'state'), \
-  builder (string, nombre de la constructora), \
-  email_requester (string, correo electrónico de quien solicita el simulador), \
-  income_updated (number, ingreso mensual actualizado del cliente), \
-  observations (string, observaciones o comentarios adicionales sobre la solicitud).", {
-    email_requester: z.string().email().min(1, "Email is required"),
-    income_updated: z.number().min(1, "Income is required"),
-    observations: z.string().min(1, "Observations are required"),
-    identification: z.string().min(1, "Identification number is required"),
-    origen_identification: z.string().min(1, "Origen is required"),
-    builder: z.string().min(1, "Builder is required"),
-}, async ({ identification, origen_identification, builder, email_requester, income_updated, observations }) => {
+// ===============================
+// 🧮 Herramienta: Obtener Historia de Crédito
+// ===============================
+server.tool("get_hdc_by_lead", `Args:
+  id_lead (number): ID del lead para obtener la historia de crédito.`, {
+    idLead: z
+        .number()
+        .min(1, "El ID del lead es obligatorio."),
+}, async ({ idLead }) => {
+    return errorHandler(async () => {
+        const hdcData = await getHdcByIdLead(idLead);
+        return {
+            content: [
+                { type: "text", text: JSON.stringify(hdcData, null, 2) },
+            ],
+        };
+    });
+});
+// ===============================
+// 🧮 Herramienta: Obtener calculadoras
+// ===============================
+server.tool("get_info_calculators", `Args:
+  identifications (list[number]): Lista de números de identificación del usuario.
+  entityKey (str): Clave de la entidad.`, {
+    identifications: z
+        .array(z.number())
+        .min(1, "Debe proporcionar al menos un número de identificación."),
+    entityKey: z
+        .string()
+        .min(1, "La clave de la entidad es obligatoria."),
+}, async ({ identifications, entityKey }) => {
+    return errorHandler(async () => {
+        const infoCalculators = [];
+        for (const id of identifications) {
+            const calculator = await assign_and_get_last_calculator({
+                identificationNumber: id,
+                entityKey,
+            });
+            infoCalculators.push({ identification: id, calculator });
+        }
+        return {
+            content: [
+                { type: "text", text: JSON.stringify(infoCalculators, null, 2) },
+            ],
+        };
+    });
+});
+// ===============================
+// 🔢 Herramienta: Asignar y obtener última calculadora
+// ===============================
+server.tool("assign_and_get_last_calculator", `Args:
+  identification (number): Número de identificación del usuario.
+  entityKey (str): Clave de la entidad.`, {
+    identification: z
+        .number()
+        .min(1, "El número de identificación es obligatorio."),
+    entityKey: z
+        .string()
+        .min(1, "La clave de la entidad es obligatoria."),
+}, async ({ identification, entityKey }) => {
+    return errorHandler(async () => {
+        const calculator = await assign_and_get_last_calculator({
+            identificationNumber: identification,
+            entityKey,
+        });
+        return {
+            content: [{ type: "text", text: JSON.stringify(calculator, null, 2) }],
+        };
+    });
+});
+// ===============================
+// 🧾 Herramienta: Generar simulador financiero
+// ===============================
+server.tool("generate_simulator", `Genera un simulador financiero para un usuario usando su número de documento. 
+  Campos requeridos:
+  - identification (string): Número de documento del cliente o número del lead.
+  - origen_identification (string): Origen de la identificación ('input' o 'state').
+  - builder (string): Nombre de la constructora.
+  - email_requester (string): Correo electrónico de quien solicita el simulador.
+  - income_updated (number): Ingreso mensual actualizado del cliente.
+  - observations (string): Observaciones o comentarios adicionales.`, {
+    email_requester: z
+        .string()
+        .email("Debe ingresar un correo electrónico válido.")
+        .min(1, "El correo electrónico es obligatorio."),
+    income_updated: z
+        .number()
+        .min(1, "El ingreso mensual actualizado es obligatorio."),
+    observations: z
+        .string()
+        .min(1, "Las observaciones son obligatorias."),
+    identification: z
+        .string()
+        .min(1, "El número de identificación es obligatorio."),
+    origen_identification: z
+        .string()
+        .min(1, "El origen de la identificación es obligatorio."),
+    builder: z
+        .string()
+        .min(1, "El nombre de la constructora es obligatorio."),
+}, async ({ identification, origen_identification, builder, email_requester, income_updated, observations, }) => {
     return errorHandler(async () => {
         const user = await generateSimulator({
             identification,
@@ -34,10 +123,12 @@ server.tool("generate_simulator", "Genera un simulador financiero para un usuari
             emailRequest: email_requester,
         });
         return {
-            content: [{ type: "text", text: JSON.stringify(user, null, 2) }]
+            content: [{ type: "text", text: JSON.stringify(user, null, 2) }],
         };
     });
 });
-// Start receiving messages on stdin and sending messages on stdout
+// ===============================
+// 🚀 Iniciar servidor MCP
+// ===============================
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koggitechorg/koggi-mcp-server",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "type": "module",
   "main": "dist/index.js",
   "bin": {

package/src/handlers/calculator.ts

@@ -0,0 +1,17 @@
+import { validateRequestToken } from "../middlewares/middleware.js";
+import { apiFetch } from "../utils/apiClient.js";
+
+interface CalculatorData {
+  [key: string]: any;
+}
+
+async function assign_and_get_last_calculator(data: CalculatorData): Promise<any> {
+  return await validateRequestToken(async () => apiFetch(`/api/monitoreo-financiero/last-calculator-by-identification-for-builder`, {
+    method: "POST",
+    body: JSON.stringify(data),
+  }));
+}
+
+export {
+  assign_and_get_last_calculator,
+}

package/src/handlers/hdc.ts

@@ -0,0 +1,12 @@
+import { validateRequestToken } from "../middlewares/middleware.js";
+import { apiFetch } from "../utils/apiClient.js";
+
+
+
+async function getHdcByIdLead(idLead: number): Promise<any> {
+    return await validateRequestToken(async () => apiFetch(`/api/monitoreo-financiero/get-hdc-by-lead`, {
+        method: "POST",
+        body: JSON.stringify({ idLead }),
+    }));
+}
+export { getHdcByIdLead };

package/src/index.ts

@@ -4,51 +4,170 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { z } from "zod";
 import { generateSimulator } from "./handlers/simulator.js";
 import { errorHandler } from "./error/error.handler.js";
+import { assign_and_get_last_calculator } from "./handlers/calculator.js";
+import { getHdcByIdLead } from "./handlers/hdc.js";
 
-// Create an MCP server
+// Crear el servidor MCP
 const server = new McpServer({
-  name: "koggi-mcp-server",
-  version: "1.0.10",
-  description: "Custom MCP server for Koggi",
+    name: "koggi-mcp-server",
+    version: "1.0.12",
+    description: "Servidor MCP Profiling personalizado para Koggi",
 });
 
+// ===============================
+// 🧮 Herramienta: Obtener Historia de Crédito
+// ===============================
+server.tool("get_hdc_by_lead", `
+  Obtiene la historia de crédito (HDC) de un lead dado su ID.   
+ Args:
+  id_lead (number): ID del lead para obtener la historia de crédito.`, {
+    idLead: z
+        .number()
+        .min(1, "El ID del lead es obligatorio."),
+}, async ({ idLead }) => {
+    return errorHandler(async () => {
+        const hdcData = await getHdcByIdLead(idLead);
+        return {
+            content: [
+                { type: "text", text: JSON.stringify(hdcData, null, 2) },
+            ],
+        };
+    });
+}
+);
 
+// ===============================
+// 🧮 Herramienta: Obtener calculadoras
+// ===============================
 server.tool(
-  "generate_simulator",
-  "Genera un simulador financiero para un usuario usando su número de documento. Campos requeridos: \
-  identification (string, número de documento del cliente o número del lead), \
-  origen_identification (string, origen de la identificación del lead puede tener dos valores 'input' o 'state'), \
-  builder (string, nombre de la constructora), \
-  email_requester (string, correo electrónico de quien solicita el simulador), \
-  income_updated (number, ingreso mensual actualizado del cliente), \
-  observations (string, observaciones o comentarios adicionales sobre la solicitud).",
-  {
-    email_requester: z.string().email().min(1, "Email is required"),
-    income_updated: z.number().min(1, "Income is required"),
-    observations: z.string().min(1, "Observations are required"),
-    identification: z.string().min(1, "Identification number is required"),
-    origen_identification: z.string().min(1, "Origen is required"),
-    builder: z.string().min(1, "Builder is required"),
-  },
-  async ({ identification, origen_identification, builder, email_requester, income_updated, observations }) => {
-    return errorHandler(async () => {
-      const user = await generateSimulator({
+    "get_info_calculators",
+    `
+  Obtene información de las últimas calculadoras asignadas a una lista de números de identificación.
+  Args:
+  identifications (list[number]): Lista de números de identificación del usuario.
+  entityKey (str): Clave de la entidad.`,
+    {
+        identifications: z
+            .array(z.number())
+            .min(1, "Debe proporcionar al menos un número de identificación."),
+        entityKey: z
+            .string()
+            .min(1, "La clave de la entidad es obligatoria."),
+    },
+    async ({ identifications, entityKey }) => {
+        return errorHandler(async () => {
+            const infoCalculators = [];
+
+            for (const id of identifications) {
+                const calculator = await assign_and_get_last_calculator({
+                    identificationNumber: id,
+                    entityKey,
+                });
+                infoCalculators.push({ identification: id, calculator });
+            }
+
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(infoCalculators, null, 2) },
+                ],
+            };
+        });
+    }
+);
+
+// ===============================
+// 🔢 Herramienta: Asignar y obtener última calculadora
+// ===============================
+server.tool(
+    "assign_and_get_last_calculator",
+    `
+  obtiene la última calculadora asignada a un número de identificación.
+  Args:
+  identification (number): Número de identificación del usuario.
+  entityKey (str): Clave de la entidad.`,
+    {
+        identification: z
+            .number()
+            .min(1, "El número de identificación es obligatorio."),
+        entityKey: z
+            .string()
+            .min(1, "La clave de la entidad es obligatoria."),
+    },
+    async ({ identification, entityKey }) => {
+        return errorHandler(async () => {
+            const calculator = await assign_and_get_last_calculator({
+                identificationNumber: identification,
+                entityKey,
+            });
+
+            return {
+                content: [{ type: "text", text: JSON.stringify(calculator, null, 2) }],
+            };
+        });
+    }
+);
+
+// ===============================
+// 🧾 Herramienta: Generar simulador financiero
+// ===============================
+server.tool(
+    "generate_simulator",
+    `Genera un simulador financiero para un usuario usando su número de documento. 
+  Campos requeridos:
+  - identification (string): Número de documento del cliente o número del lead.
+  - origen_identification (string): Origen de la identificación ('input' o 'state').
+  - builder (string): Nombre de la constructora.
+  - email_requester (string): Correo electrónico de quien solicita el simulador.
+  - income_updated (number): Ingreso mensual actualizado del cliente.
+  - observations (string): Observaciones o comentarios adicionales.`,
+    {
+        email_requester: z
+            .string()
+            .email("Debe ingresar un correo electrónico válido.")
+            .min(1, "El correo electrónico es obligatorio."),
+        income_updated: z
+            .number()
+            .min(1, "El ingreso mensual actualizado es obligatorio."),
+        observations: z
+            .string()
+            .min(1, "Las observaciones son obligatorias."),
+        identification: z
+            .string()
+            .min(1, "El número de identificación es obligatorio."),
+        origen_identification: z
+            .string()
+            .min(1, "El origen de la identificación es obligatorio."),
+        builder: z
+            .string()
+            .min(1, "El nombre de la constructora es obligatorio."),
+    },
+    async ({
         identification,
         origen_identification,
         builder,
-        ingresosActualizados: income_updated,
-        observaciones: observations,
-        emailRequest: email_requester,
-      });
-
-      return {
-        content: [{ type: "text", text: JSON.stringify(user, null, 2) }]
-      };
-    });
-  }
-);
+        email_requester,
+        income_updated,
+        observations,
+    }) => {
+        return errorHandler(async () => {
+            const user = await generateSimulator({
+                identification,
+                origen_identification,
+                builder,
+                ingresosActualizados: income_updated,
+                observaciones: observations,
+                emailRequest: email_requester,
+            });
 
+            return {
+                content: [{ type: "text", text: JSON.stringify(user, null, 2) }],
+            };
+        });
+    }
+);
 
-// Start receiving messages on stdin and sending messages on stdout
+// ===============================
+// 🚀 Iniciar servidor MCP
+// ===============================
 const transport = new StdioServerTransport();
-await server.connect(transport);
+await server.connect(transport);