@koggitechorg/koggi-mcp-server 1.0.2 → 1.0.4

package/README.md

@@ -1,2 +1,71 @@
-# mcp-koggi-package
 # 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.
+
+## 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/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`
+	- 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`).
+- Comunicación: stdin/stdout (StdioServerTransport) siguiendo el SDK `@modelcontextprotocol/sdk`.
+- Cliente HTTP: usa `node-fetch` y `EXTERNAL_URL` como base para las peticiones.
+
+## Requisitos
+
+- Node.js 18+ (o compatible con ESM y fetch nativo).
+- npm
+
+
+## Configuración y ejecución (ejemplos de integración)
+
+En lugar de instrucciones de instalación local, aquí hay ejemplos prácticos para integrar el servidor en un flujo MCP o en ADK.
+
+Ejemplo `mcp.json` (útil para ejecutar con orquestadores que esperan ese formato):
+
+```json
+{
+	"servers": {
+		"koggi-mcp-server": {
+			"command": "npx",
+			"args": [
+				"-y", "@koggitechorg/koggi-mcp-server"
+			],
+			"env": {
+				"EXTERNAL_URL": "https://external-qa-502142473966.us-central1.run.app"
+			}
+		}
+	},
+	"inputs": []
+}
+```
+
+Ejemplo de integración en ADK (snippet Python) usando parámetros de Stdio:
+
+```py
+tools = [
+		MCPToolsetConParseo(
+				connection_params=StdioServerParameters(
+						command="npx",
+						args=["-y", "@koggitechorg/koggi-mcp-server"],
+						env={"EXTERNAL_URL": EXTERNAL_URL},
+				)
+		),
+]
+```
+
+Estos ejemplos muestran cómo arrancar el servidor desde `npx` (instalación bajo demanda) y pasar `EXTERNAL_URL` como variable de entorno. `EXTERNAL_URL` se concatena con las rutas internas definidas en el cliente HTTP (`src/utils/apiClient.ts`).
+
+## Licencia
+
+Licencia no especificada en el repo. Añade un `LICENSE` si quieres publicar bajo una licencia permissiva (MIT, Apache-2.0, etc.).
+
+## Contacto
+
+Si necesitas ayuda para adaptar el servidor (p. ej. cambiar transporte, añadir nuevas tools o endpoints), abre un issue o contacta al equipo de Koggitech.

package/dist/config/config.js

@@ -2,4 +2,5 @@ import dotenv from "dotenv";
 dotenv.config();
 export const CONFIG = {
     apiUrl: process.env.EXTERNAL_URL || "",
+    token: process.env.API_TOKEN || "",
 };

package/dist/handlers/simulator.js

@@ -1,8 +1,9 @@
+import { validateRequestToken } from "../middlewares/middleware.js";
 import { apiFetch } from "../utils/apiClient.js";
 async function generateSimulator(data) {
-    return apiFetch(`/api/monitoreo-financiero/simulate-new-calculator-by-id-lead`, {
+    return await validateRequestToken(async () => apiFetch(`/api/monitoreo-financiero/simulate-new-calculator-by-id-lead`, {
         method: "POST",
         body: JSON.stringify(data),
-    });
+    }));
 }
 export { generateSimulator };

package/dist/middlewares/middleware.js

@@ -0,0 +1,21 @@
+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." }];
+    }
+    return await func();
+}
+async function validateToken(token) {
+    const response = await apiFetch(`/api/mcp/validate`, {
+        method: "POST",
+        headers: {
+            "Authorization": `Bearer ${token}`
+        }
+    });
+    console.log("Token validation response:", response);
+    return response?.success;
+}
+export { validateRequestToken };

package/package.json

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

package/src/config/config.ts

@@ -1,6 +1,12 @@
 import dotenv from "dotenv";
 dotenv.config();
 
-export const CONFIG: { apiUrl: string } = {
+interface Config { 
+  apiUrl: string;
+  token: string;
+}
+
+export const CONFIG: Config = {
   apiUrl: process.env.EXTERNAL_URL || "",
+  token: process.env.API_TOKEN || "",
 };

package/src/handlers/simulator.ts

@@ -1,3 +1,4 @@
+import { validateRequestToken } from "../middlewares/middleware.js";
 import { apiFetch } from "../utils/apiClient.js";
 
 interface SimulatorData {
@@ -5,10 +6,10 @@ interface SimulatorData {
 }
 
 async function generateSimulator(data: SimulatorData): Promise<void> {
-  return apiFetch(`/api/monitoreo-financiero/simulate-new-calculator-by-id-lead`, {
+  return await validateRequestToken(async () => apiFetch(`/api/monitoreo-financiero/simulate-new-calculator-by-id-lead`, {
     method: "POST",
     body: JSON.stringify(data),
-  });
+  }));
 }
 
 export {

package/src/index.ts

@@ -11,6 +11,7 @@ const server = new McpServer({
   description: "Custom MCP server for Koggi",
 });
 
+
 server.tool(
   "generateSimulator",
   "Genera un simulador financiero para un usuario usando su número de documento. Campos requeridos: \

package/src/middlewares/middleware.ts

@@ -0,0 +1,27 @@
+import { CONFIG } from "../config/config.js";
+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." }];
+  }
+  return await func();
+}
+
+async function validateToken(token: string): Promise<boolean> {
+  const response = await apiFetch(`/api/mcp/validate`, {
+    method: "POST",
+    headers: {
+        "Authorization": `Bearer ${token}`
+    }
+  });
+  console.log("Token validation response:", response);
+  return response?.success;
+}
+
+
+export {
+  validateRequestToken
+}

package/src/config/config.js

@@ -1,7 +0,0 @@
-import dotenv from "dotenv";
-dotenv.config();
-
-export const CONFIG = {
-  apiUrl: process.env.EXTERNAL_URL || "https://api.miapi.com/v1",
-  apiHeaders: JSON.parse(process.env.OPENAPI_MCP_HEADERS || "{}"),
-};

package/src/handlers/simulator.js

@@ -1,10 +0,0 @@
-import { apiFetch } from "../utils/apiClient.js";
-
-async function generateSimulator(id) {
-  return apiFetch(`/simulators/${id}`);
-}
-
-
-export {
-  generateSimulator
-}

package/src/index.js

@@ -1,29 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { buildHandlers } from "./server.js";
-
-async function main() {
-  console.log("🚀 Starting koggi-mcp-server...");
-
-  const server = new McpServer({
-    name: "koggi-mcp-server",
-    version: "1.0.0",
-    description: "Custom MCP server for Koggi",
-  });
-
-  const handlers = await buildHandlers();
-
-  for (const tool of handlers) {
-    server.tool(tool.name, tool.description, tool.schema, tool.handler);
-  }
-
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-
-  console.log("✅ koggi-mcp-server running...");
-}
-
-main().catch((err) => {
-  console.error("❌ Server failed:", err);
-  process.exit(1);
-});

package/src/server.js

@@ -1,20 +0,0 @@
-import { z } from "zod";
-import { generateSimulator } from "./handlers/simulator.js";
-
-export async function buildHandlers() {
-  return [
-    {
-      name: "generateSimulator",
-      description: "generate financial simulator for a user using document number ",
-      schema: z.object({
-        id: z.string().describe("User ID to fetch"),
-      }),
-      handler: async ({ id }) => {
-        const user = await generateSimulator(id);
-        return {
-          content: [{ type: "text", text: JSON.stringify(user, null, 2) }],
-        };
-      },
-    },
-  ];
-}

package/src/utils/apiClient.js

@@ -1,16 +0,0 @@
-import { CONFIG } from "../config/config.js";
-
-
-export async function apiFetch(path, options = {}) {
-  const res = await fetch(`${CONFIG.apiUrl}${path}`, {
-    ...options,
-    headers: { ...CONFIG.apiHeaders, ...(options.headers || {}) },
-  });
-
-  if (!res.ok) {
-    const text = await res.text();
-    throw new Error(`API error ${res.status}: ${text}`);
-  }
-
-  return res.json();
-}