@koggitechorg/koggi-mcp-server 1.0.4 → 1.0.6

package/README.md

@@ -1,19 +1,19 @@
 # koggi-mcp-server
 
-Una herramienta (MCP server) ligera para exponer un comando/tool llamado `generateSimulator` usado para generar un simulador financiero basándose en el número de documento (id de lead) de un usuario. El servidor implementa el protocolo Model Context Protocol (MCP) y está pensado para integrarse con agentes o sistemas que hablen MCP por stdin/stdout.
+Una herramienta (MCP server) ligera para exponer un comando/tool llamado `generate_simulator` usado para generar un simulador financiero basándose en el número de documento (id de lead) de un usuario. El servidor implementa el protocolo Model Context Protocol (MCP) y está pensado para integrarse con agentes o sistemas que hablen MCP por stdin/stdout.
 
 ## Contenido
 
-- `src/index.ts` - Entrada principal que registra la tool `generateSimulator` y arranca el servidor MCP usando `StdioServerTransport`.
-- `src/handlers/simulator.ts` - Handlers/implementación auxiliar del handler `generateSimulator` (versiones JS/TS).
+- `src/index.ts` - Entrada principal que registra la tool `generate_simulator` y arranca el servidor MCP usando `StdioServerTransport`.
+- `src/handlers/simulator.ts` - Handlers/implementación auxiliar del handler `generate_simulator` (versiones JS/TS).
 - `src/utils/apiClient.ts` - Cliente HTTP usado para llamar al endpoint interno/external que calcula el simulador.
 - `src/config/config.ts` - Carga de variables de entorno (usa `dotenv`).
 
 ## Características
 
-- Tool MCP: `generateSimulator`
+- Tool MCP: `generate_simulator`
 	- Propósito: Generar un simulador financiero para un usuario dado.
-	- Schema (Zod): `id_lead`, `email_requester`, `income_updated`, `observations` (todos obligatorios en la versión TS de `index.ts`).
+	- Schema (Zod): `id_lead`, `identification_number`,`builder`,`email_requester`, `income_updated`, `observations` (email_requester,income_updated,observations 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.
 
@@ -38,7 +38,8 @@ Ejemplo `mcp.json` (útil para ejecutar con orquestadores que esperan ese format
 				"-y", "@koggitechorg/koggi-mcp-server"
 			],
 			"env": {
-				"EXTERNAL_URL": "https://external-qa-502142473966.us-central1.run.app"
+				"EXTERNAL_URL": "https://external-qa-502142473966.us-central1.run.app",
+				"API_TOKEN": "23slKk2..."
 			}
 		}
 	},
@@ -54,7 +55,7 @@ tools = [
 				connection_params=StdioServerParameters(
 						command="npx",
 						args=["-y", "@koggitechorg/koggi-mcp-server"],
-						env={"EXTERNAL_URL": EXTERNAL_URL},
+						env={"EXTERNAL_URL": EXTERNAL_URL, "API_TOKEN": "..."},
 				)
 		),
 ]

package/dist/error/error.handler.js

@@ -0,0 +1,11 @@
+export async function errorHandler(func) {
+    try {
+        return await func();
+    }
+    catch (err) {
+        console.error('Error:', err);
+        return {
+            content: [{ type: "text", text: `Ocurrió un error: ${err?.message ?? String(err)}` }]
+        };
+    }
+}

package/dist/index.js

@@ -3,31 +3,40 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 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
 const server = new McpServer({
     name: "koggi-mcp-server",
     version: "1.0.0",
     description: "Custom MCP server for Koggi",
 });
-server.tool("generateSimulator", "Genera un simulador financiero para un usuario usando su número de documento. Campos requeridos: \
+server.tool("generate_simulator", "Genera un simulador financiero para un usuario usando su número de documento. Campos requeridos: \
   id_lead (string, identificador único del lead), \
+  identification_number (string, número de documento del cliente), \
+  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).", {
-    id_lead: z.string().min(1, "Lead ID is required"),
+    id_lead: z.string().isOptional(),
+    identification_number: z.string().isOptional(),
+    builder: z.string().isOptional(),
     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"),
-}, async ({ id_lead, email_requester, income_updated, observations }) => {
-    const user = await generateSimulator({
-        idLead: id_lead,
-        ingresosActualizados: income_updated,
-        observaciones: observations,
-        emailRequest: email_requester,
+}, async ({ id_lead, identification_number, builder, email_requester, income_updated, observations }) => {
+    return errorHandler(async () => {
+        const user = await generateSimulator({
+            idLead: id_lead,
+            identification_number,
+            builder,
+            ingresosActualizados: income_updated,
+            observaciones: observations,
+            emailRequest: email_requester,
+        });
+        return {
+            content: [{ type: "text", text: JSON.stringify(user, null, 2) }]
+        };
     });
-    return {
-        content: [{ type: "text", text: JSON.stringify(user, null, 2) }]
-    };
 });
 // Start receiving messages on stdin and sending messages on stdout
 const transport = new StdioServerTransport();

package/dist/middlewares/middleware.js

@@ -2,11 +2,16 @@ import { CONFIG } from "../config/config.js";
 import { apiFetch } from "../utils/apiClient.js";
 async function validateRequestToken(func) {
     const token = CONFIG.token;
-    const isValid = await validateToken(token);
-    if (!isValid) {
-        return [{ type: "text", text: "Invalid request token." }];
+    try {
+        const isValid = await validateToken(token);
+        if (!isValid) {
+            throw new Error("Invalid request token.");
+        }
+        return await func();
+    }
+    catch (err) {
+        return [{ type: "text", text: `Error al validar token o ejecutando la acción: ${err?.message ?? String(err)}` }];
     }
-    return await func();
 }
 async function validateToken(token) {
     const response = await apiFetch(`/api/mcp/validate`, {

package/package.json

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

package/src/error/error.handler.ts

@@ -0,0 +1,10 @@
+export async function errorHandler(func: Function) {
+  try {
+    return await func();
+  } catch (err: any) {
+    console.error('Error:', err);
+    return {
+      content: [{ type: "text", text: `Ocurrió un error: ${err?.message ?? String(err)}` }]
+    };
+  }
+}

package/src/handlers/simulator.ts

@@ -5,7 +5,7 @@ interface SimulatorData {
   [key: string]: any;
 }
 
-async function generateSimulator(data: SimulatorData): Promise<void> {
+async function generateSimulator(data: SimulatorData): Promise<any> {
   return await validateRequestToken(async () => apiFetch(`/api/monitoreo-financiero/simulate-new-calculator-by-id-lead`, {
     method: "POST",
     body: JSON.stringify(data),

package/src/index.ts

@@ -3,6 +3,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 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
 const server = new McpServer({
@@ -13,31 +14,41 @@ const server = new McpServer({
 
 
 server.tool(
-  "generateSimulator",
+  "generate_simulator",
   "Genera un simulador financiero para un usuario usando su número de documento. Campos requeridos: \
   id_lead (string, identificador único del lead), \
+  identification_number (string, número de documento del cliente), \
+  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).",
   {
-    id_lead: z.string().min(1, "Lead ID is required"),
+    id_lead: z.string().isOptional(),
+    identification_number: z.string().isOptional(),
+    builder: z.string().isOptional(),
     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"),
   },
-  async ({ id_lead, email_requester, income_updated, observations }) => {
-    const user = await generateSimulator({
-      idLead: id_lead,
-      ingresosActualizados: income_updated,
-      observaciones: observations,
-      emailRequest: email_requester,
+  async ({ id_lead, identification_number, builder, email_requester, income_updated, observations }) => {
+    return errorHandler(async () => {
+      const user = await generateSimulator({
+        idLead: id_lead,
+        identification_number,
+        builder,
+        ingresosActualizados: income_updated,
+        observaciones: observations,
+        emailRequest: email_requester,
+      });
+
+      return {
+        content: [{ type: "text", text: JSON.stringify(user, null, 2) }]
+      };
     });
-    return {
-      content: [{ type: "text", text: JSON.stringify(user, null, 2) }]
-    };
   }
 );
 
+
 // Start receiving messages on stdin and sending messages on stdout
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/src/middlewares/middleware.ts

@@ -3,13 +3,18 @@ import { apiFetch } from "../utils/apiClient.js";
 
 async function validateRequestToken(func: Function) {
   const token = CONFIG.token;
-  const isValid = await validateToken(token); 
-  if (!isValid ) {
-    return  [{ type: "text", text: "Invalid request token." }];
+  try {
+    const isValid = await validateToken(token);
+    if (!isValid) {
+      throw new Error("Invalid request token.");
+    }
+    return await func();
+  } catch (err: any) {
+    return [{ type: "text", text:  `Error al validar token o ejecutando la acción: ${err?.message ?? String(err)}` }];
   }
-  return await func();
 }
 
+
 async function validateToken(token: string): Promise<boolean> {
   const response = await apiFetch(`/api/mcp/validate`, {
     method: "POST",