@ssolis-ti/mcp-compra-agil 1.0.2

package/dist/utils/rate-limiter.js

@@ -0,0 +1,82 @@
+/**
+ * Control inteligente de rate limiting para la API de Compra Ágil.
+ *
+ * La API usa cuota por día calendario (se resetea a medianoche UTC).
+ * Este módulo lleva un contador local de requests para advertir
+ * proactivamente antes de alcanzar el límite.
+ */
+import { logger } from './logger.js';
+export class RateLimiter {
+    requestCount = 0;
+    currentDay;
+    isLimited = false;
+    limitResetTime = null;
+    constructor() {
+        this.currentDay = this.getTodayUTC();
+    }
+    getTodayUTC() {
+        return new Date().toISOString().split('T')[0];
+    }
+    /**
+     * Registra un request exitoso. Resetea el contador si cambió el día.
+     */
+    recordRequest() {
+        const today = this.getTodayUTC();
+        if (today !== this.currentDay) {
+            this.requestCount = 0;
+            this.currentDay = today;
+            this.isLimited = false;
+            this.limitResetTime = null;
+            logger.info('Rate limiter: contador diario reseteado (nuevo día calendario UTC).');
+        }
+        this.requestCount++;
+        logger.debug(`Rate limiter: request #${this.requestCount} del día.`);
+    }
+    /**
+     * Marca que se recibió un error 429.
+     */
+    markLimited() {
+        this.isLimited = true;
+        const now = new Date();
+        const tomorrow = new Date(now);
+        tomorrow.setUTCDate(tomorrow.getUTCDate() + 1);
+        tomorrow.setUTCHours(0, 1, 0, 0);
+        this.limitResetTime = tomorrow;
+        logger.warn(`Rate limiter: cuota agotada. Reset estimado: ${tomorrow.toISOString()}`);
+    }
+    /**
+     * Verifica si estamos actualmente limitados.
+     */
+    checkLimit() {
+        if (!this.isLimited) {
+            return { limited: false };
+        }
+        const now = new Date();
+        if (this.limitResetTime && now >= this.limitResetTime) {
+            this.isLimited = false;
+            this.limitResetTime = null;
+            this.requestCount = 0;
+            this.currentDay = this.getTodayUTC();
+            return { limited: false };
+        }
+        const waitMs = this.limitResetTime
+            ? this.limitResetTime.getTime() - now.getTime()
+            : 0;
+        const waitHours = Math.ceil(waitMs / (1000 * 60 * 60));
+        return {
+            limited: true,
+            resetIn: `aproximadamente ${waitHours} hora(s)`,
+        };
+    }
+    /**
+     * Obtiene estadísticas del uso actual.
+     */
+    getStats() {
+        return {
+            requestsToday: this.requestCount,
+            isLimited: this.isLimited,
+            resetTime: this.limitResetTime?.toISOString() ?? null,
+        };
+    }
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/utils/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,OAAO,WAAW;IACd,YAAY,GAAG,CAAC,CAAC;IACjB,UAAU,CAAS;IACnB,SAAS,GAAG,KAAK,CAAC;IAClB,cAAc,GAAgB,IAAI,CAAC;IAE3C;QACE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACvC,CAAC;IAEO,WAAW;QACjB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,aAAa;QACX,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACjC,IAAI,KAAK,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;YAC9B,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;YACtB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;YACxB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YACvB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,MAAM,CAAC,KAAK,CAAC,0BAA0B,IAAI,CAAC,YAAY,WAAW,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,WAAW;QACT,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/B,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;QAC/C,QAAQ,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACjC,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,gDAAgD,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACxF,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC5B,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,cAAc,IAAI,GAAG,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACtD,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YACvB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;YAC3B,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;YACtB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YACrC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC5B,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc;YAChC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE;YAC/C,CAAC,CAAC,CAAC,CAAC;QACN,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAEvD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,mBAAmB,SAAS,UAAU;SAChD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,YAAY;YAChC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,EAAE,IAAI,IAAI;SACtD,CAAC;IACJ,CAAC;CACF"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@ssolis-ti/mcp-compra-agil",
+  "version": "1.0.2",
+  "description": "Servidor MCP para la API Compra Ágil v2 de Mercado Público (Chile)",
+  "type": "module",
+  "bin": {
+    "mcp-compra-agil": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "author": "ssolis-ti",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ssolis-ti/compra-agil-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ssolis-ti/compra-agil-mcp/issues"
+  },
+  "homepage": "https://github.com/ssolis-ti/compra-agil-mcp#readme",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx watch src/index.ts",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js",
+    "monitor": "node dist/services/monitor.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "pdf-parse": "^2.4.5",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/pdf-parse": "^1.1.5",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "compra-agil",
+    "mercado-publico",
+    "chile",
+    "gobierno",
+    "licitaciones"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}