@koggitechorg/koggi-mcp-server 1.0.10 → 1.0.11

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/index.js

@@ -4,26 +4,96 @@ 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";
+// 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 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 +104,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.11",
   "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/index.ts

@@ -4,33 +4,124 @@ 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";
 
-// 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",
+  version: "1.0.11",
+  description: "Servidor MCP personalizado para Koggi",
 });
 
+// ===============================
+// 🧮 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 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).",
+  `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().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"),
+    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 }) => {
+  async ({
+    identification,
+    origen_identification,
+    builder,
+    email_requester,
+    income_updated,
+    observations,
+  }) => {
     return errorHandler(async () => {
       const user = await generateSimulator({
         identification,
@@ -42,13 +133,14 @@ server.tool(
       });
 
       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);
+await server.connect(transport);