@brazil-mcp/cep 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+async function main() {
+    const { server } = createServer();
+    await server.connect(new StdioServerTransport());
+    console.error("[cep-mcp] Server iniciado via stdio");
+}
+main().catch((err) => { console.error("[cep-mcp] Erro fatal:", err); process.exit(1); });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;IAClC,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;IACjD,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;AACvD,CAAC;AACD,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/providers/brasilapi.d.ts

@@ -0,0 +1,5 @@
+import type { CepData, CepProvider } from "../types.js";
+export declare class BrasilApiCepProvider implements CepProvider {
+    name: string;
+    fetchCep(cep: string): Promise<CepData>;
+}

package/dist/providers/brasilapi.js

@@ -0,0 +1,14 @@
+export class BrasilApiCepProvider {
+    name = "BrasilAPI";
+    async fetchCep(cep) {
+        const res = await fetch(`https://brasilapi.com.br/api/cep/v2/${cep}`, { headers: { Accept: "application/json" }, signal: AbortSignal.timeout(10_000) });
+        if (!res.ok) {
+            if (res.status === 404)
+                throw new Error(`CEP ${cep} não encontrado.`);
+            throw new Error(`BrasilAPI CEP retornou status ${res.status}`);
+        }
+        const raw = await res.json();
+        return { cep: (raw.cep || "").replace(/\D/g, ""), logradouro: raw.street || "", complemento: "", bairro: raw.neighborhood || "", cidade: raw.city || "", uf: raw.state || "", ibge: raw.city_ibge || "", ddd: "" };
+    }
+}
+//# sourceMappingURL=brasilapi.js.map

package/dist/providers/brasilapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brasilapi.js","sourceRoot":"","sources":["../../src/providers/brasilapi.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,oBAAoB;IAC/B,IAAI,GAAG,WAAW,CAAC;IACnB,KAAK,CAAC,QAAQ,CAAC,GAAW;QACxB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,uCAAuC,GAAG,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxJ,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;gBAAE,MAAM,IAAI,KAAK,CAAC,OAAO,GAAG,kBAAkB,CAAC,CAAC;YACtE,MAAM,IAAI,KAAK,CAAC,iCAAiC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC7B,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,IAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAC,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,IAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,YAAY,IAAE,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,IAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,KAAK,IAAE,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,SAAS,IAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;IACxM,CAAC;CACF"}

package/dist/providers/index.d.ts

@@ -0,0 +1,9 @@
+import type { CepData, CepProvider } from "../types.js";
+export declare class CepService {
+    private providers;
+    private cache;
+    constructor(providers?: CepProvider[]);
+    lookup(cep: string): Promise<CepData>;
+    clearCache(): void;
+    get cacheSize(): number;
+}

package/dist/providers/index.js

@@ -0,0 +1,32 @@
+import { ViaCepProvider } from "./viacep.js";
+import { BrasilApiCepProvider } from "./brasilapi.js";
+export class CepService {
+    providers;
+    cache = new Map();
+    constructor(providers) { this.providers = providers ?? [new ViaCepProvider(), new BrasilApiCepProvider()]; }
+    async lookup(cep) {
+        const cached = this.cache.get(cep);
+        if (cached && Date.now() < cached.expiry) {
+            console.error(`[cep-mcp] Cache hit para ${cep}`);
+            return cached.data;
+        }
+        const errors = [];
+        for (const p of this.providers) {
+            try {
+                console.error(`[cep-mcp] Consultando ${p.name} para ${cep}`);
+                const data = await p.fetchCep(cep);
+                this.cache.set(cep, { data, expiry: Date.now() + 86_400_000 });
+                return data;
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.error(`[cep-mcp] ${p.name} falhou: ${msg}`);
+                errors.push(`${p.name}: ${msg}`);
+            }
+        }
+        throw new Error(`Não foi possível consultar o CEP ${cep}. Erros: ${errors.join(" | ")}`);
+    }
+    clearCache() { this.cache.clear(); }
+    get cacheSize() { return this.cache.size; }
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,OAAO,UAAU;IACb,SAAS,CAAgB;IACzB,KAAK,GAAG,IAAI,GAAG,EAA6C,CAAC;IACrE,YAAY,SAAyB,IAAI,IAAI,CAAC,SAAS,GAAG,SAAS,IAAI,CAAC,IAAI,cAAc,EAAE,EAAE,IAAI,oBAAoB,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5H,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YAAC,OAAO,CAAC,KAAK,CAAC,4BAA4B,GAAG,EAAE,CAAC,CAAC;YAAC,OAAO,MAAM,CAAC,IAAI,CAAC;QAAC,CAAC;QACnH,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC;gBAAC,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC,IAAI,SAAS,GAAG,EAAE,CAAC,CAAC;gBAAC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,EAAE,CAAC,CAAC;gBAAC,OAAO,IAAI,CAAC;YAAC,CAAC;YACtL,OAAO,GAAG,EAAE,CAAC;gBAAC,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,YAAY,GAAG,EAAE,CAAC,CAAC;gBAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC,CAAC;YAAC,CAAC;QACtK,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,oCAAoC,GAAG,YAAY,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC3F,CAAC;IACD,UAAU,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACpC,IAAI,SAAS,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;CAC5C"}

package/dist/providers/viacep.d.ts

@@ -0,0 +1,5 @@
+import type { CepData, CepProvider } from "../types.js";
+export declare class ViaCepProvider implements CepProvider {
+    name: string;
+    fetchCep(cep: string): Promise<CepData>;
+}

package/dist/providers/viacep.js

@@ -0,0 +1,13 @@
+export class ViaCepProvider {
+    name = "ViaCEP";
+    async fetchCep(cep) {
+        const res = await fetch(`https://viacep.com.br/ws/${cep}/json/`, { signal: AbortSignal.timeout(10_000) });
+        if (!res.ok)
+            throw new Error(`ViaCEP retornou status ${res.status}`);
+        const raw = await res.json();
+        if (raw.erro)
+            throw new Error(`CEP ${cep} não encontrado.`);
+        return { cep: (raw.cep || "").replace(/\D/g, ""), logradouro: raw.logradouro || "", complemento: raw.complemento || "", bairro: raw.bairro || "", cidade: raw.localidade || "", uf: raw.uf || "", ibge: raw.ibge || "", ddd: raw.ddd || "" };
+    }
+}
+//# sourceMappingURL=viacep.js.map

package/dist/providers/viacep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viacep.js","sourceRoot":"","sources":["../../src/providers/viacep.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,cAAc;IACzB,IAAI,GAAG,QAAQ,CAAC;IAChB,KAAK,CAAC,QAAQ,CAAC,GAAW;QACxB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,4BAA4B,GAAG,QAAQ,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC1G,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACrE,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,GAAG,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,OAAO,GAAG,kBAAkB,CAAC,CAAC;QAC5D,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,IAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAC,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,IAAE,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,IAAE,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,IAAE,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,UAAU,IAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,IAAE,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,IAAE,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,IAAE,EAAE,EAAE,CAAC;IAC9N,CAAC;CACF"}

package/dist/server.d.ts

@@ -0,0 +1,11 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { CepService } from "./providers/index.js";
+import { DailyRateLimiter } from "./utils/rate-limiter.js";
+export declare function createServer(opts?: {
+    service?: CepService;
+    rateLimiter?: DailyRateLimiter | null;
+}): {
+    server: McpServer;
+    cepService: CepService;
+    rateLimiter: DailyRateLimiter | null;
+};

package/dist/server.js

@@ -0,0 +1,31 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { CepService } from "./providers/index.js";
+import { handleCepLookup, handleCepValidate } from "./tools/handlers.js";
+import { DailyRateLimiter, rateLimitMessage } from "./utils/rate-limiter.js";
+export function createServer(opts) {
+    const cepService = opts?.service ?? new CepService();
+    const limiter = opts?.rateLimiter === null
+        ? null
+        : opts?.rateLimiter ?? new DailyRateLimiter(50);
+    const server = new McpServer({
+        name: "cep-mcp", version: "1.0.0",
+        description: "Consulta CEP e endereços brasileiros. Plano gratuito: 50 consultas/dia.",
+    });
+    function withLimit(fn, label) {
+        if (limiter && !limiter.tryConsume()) {
+            return Promise.resolve({ content: [{ type: "text", text: rateLimitMessage(label, limiter.limit) }] });
+        }
+        return fn();
+    }
+    server.registerTool("cep_lookup", {
+        description: "Consulta endereço completo por CEP brasileiro.",
+        inputSchema: { cep: z.string().describe("CEP (com ou sem formatação)") },
+    }, async ({ cep }) => withLimit(() => handleCepLookup(cep, cepService), "CEP"));
+    server.registerTool("cep_validate", {
+        description: "Valida formato de CEP (local, sem consumir quota).",
+        inputSchema: { cep: z.string().describe("CEP para validar") },
+    }, async ({ cep }) => handleCepValidate(cep));
+    return { server, cepService, rateLimiter: limiter };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAmB,MAAM,qBAAqB,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE7E,MAAM,UAAU,YAAY,CAAC,IAG5B;IACC,MAAM,UAAU,GAAG,IAAI,EAAE,OAAO,IAAI,IAAI,UAAU,EAAE,CAAC;IACrD,MAAM,OAAO,GACX,IAAI,EAAE,WAAW,KAAK,IAAI;QACxB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,IAAI,EAAE,WAAW,IAAI,IAAI,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAEpD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO;QACjC,WAAW,EAAE,yEAAyE;KACvF,CAAC,CAAC;IAEH,SAAS,SAAS,CAAC,EAA6B,EAAE,KAAa;QAC7D,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;YACrC,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACjH,CAAC;QACD,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,YAAY,EAAE;QAChC,WAAW,EAAE,gDAAgD;QAC7D,WAAW,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC,EAAE;KACzE,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAEhF,MAAM,CAAC,YAAY,CAAC,cAAc,EAAE;QAClC,WAAW,EAAE,oDAAoD;QACjE,WAAW,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE;KAC9D,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;IAE9C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;AACtD,CAAC"}

package/dist/tools/format.d.ts

@@ -0,0 +1,2 @@
+import type { CepData } from "../types.js";
+export declare function formatCepResult(data: CepData): string;

package/dist/tools/format.js

@@ -0,0 +1,6 @@
+import { formatCep } from "../utils/cep.js";
+export function formatCepResult(data) {
+    const lines = [`CEP: ${formatCep(data.cep)}`, data.logradouro ? `Logradouro: ${data.logradouro}` : "", data.complemento ? `Complemento: ${data.complemento}` : "", data.bairro ? `Bairro: ${data.bairro}` : "", `Cidade: ${data.cidade}/${data.uf}`, data.ibge ? `Código IBGE: ${data.ibge}` : "", data.ddd ? `DDD: ${data.ddd}` : ""];
+    return lines.filter(Boolean).join("\n");
+}
+//# sourceMappingURL=format.js.map

package/dist/tools/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/tools/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,UAAU,eAAe,CAAC,IAAa;IAC3C,MAAM,KAAK,GAAG,CAAC,QAAQ,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,gBAAgB,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,WAAW,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACvU,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC"}

package/dist/tools/handlers.d.ts

@@ -0,0 +1,10 @@
+import { CepService } from "../providers/index.js";
+export interface ToolResult {
+    [key: string]: unknown;
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}
+export declare function handleCepLookup(cep: string, service: CepService): Promise<ToolResult>;
+export declare function handleCepValidate(cep: string): Promise<ToolResult>;

package/dist/tools/handlers.js

@@ -0,0 +1,19 @@
+import { cleanCep, formatCep, isValidCep } from "../utils/cep.js";
+import { formatCepResult } from "./format.js";
+function text(t) { return { content: [{ type: "text", text: t }] }; }
+export async function handleCepLookup(cep, service) {
+    const clean = cleanCep(cep);
+    if (!isValidCep(clean))
+        return text(`❌ CEP inválido: ${cep}. Deve conter 8 dígitos.`);
+    try {
+        return text(formatCepResult(await service.lookup(clean)));
+    }
+    catch (err) {
+        return text(`❌ Erro ao consultar CEP: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+export async function handleCepValidate(cep) {
+    const clean = cleanCep(cep);
+    return text(isValidCep(clean) ? `✅ CEP ${formatCep(clean)} tem formato válido.` : `❌ CEP ${cep} é inválido.`);
+}
+//# sourceMappingURL=handlers.js.map

package/dist/tools/handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../src/tools/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,SAAS,IAAI,CAAC,CAAS,IAAgB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAEzF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW,EAAE,OAAmB;IACpE,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,mBAAmB,GAAG,0BAA0B,CAAC,CAAC;IACtF,IAAI,CAAC;QAAC,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAAC,CAAC;IAClE,OAAO,GAAG,EAAE,CAAC;QAAC,OAAO,IAAI,CAAC,4BAA4B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC;AAC9G,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAW;IACjD,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,SAAS,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC,SAAS,GAAG,cAAc,CAAC,CAAC;AAChH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,14 @@
+export interface CepData {
+    cep: string;
+    logradouro: string;
+    complemento: string;
+    bairro: string;
+    cidade: string;
+    uf: string;
+    ibge: string;
+    ddd: string;
+}
+export interface CepProvider {
+    name: string;
+    fetchCep(cep: string): Promise<CepData>;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/cep.d.ts

@@ -0,0 +1,3 @@
+export declare function cleanCep(cep: string): string;
+export declare function formatCep(cep: string): string;
+export declare function isValidCep(cep: string): boolean;

package/dist/utils/cep.js

@@ -0,0 +1,10 @@
+export function cleanCep(cep) { return cep.replace(/\D/g, ""); }
+export function formatCep(cep) {
+    const c = cleanCep(cep);
+    return c.length === 8 ? c.replace(/^(\d{5})(\d{3})$/, "$1-$2") : cep;
+}
+export function isValidCep(cep) {
+    const c = cleanCep(cep);
+    return c.length === 8 && !/^0{8}$/.test(c);
+}
+//# sourceMappingURL=cep.js.map

package/dist/utils/cep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cep.js","sourceRoot":"","sources":["../../src/utils/cep.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,CAAC,GAAW,IAAY,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AAChF,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IACxB,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACvE,CAAC;AACD,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IACxB,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC7C,CAAC"}

package/dist/utils/rate-limiter.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Interface para backends de armazenamento de contagem de chamadas do rate limiter.
+ */
+export interface RateLimiterStore {
+    readonly type: "memory" | "redis";
+    /**
+     * Tenta consumir 1 unidade de rate limit para a chave no dia informado.
+     * Retorna a contagem atual após o incremento.
+     */
+    increment(key: string, day: string, ttlSeconds: number): Promise<number> | number;
+    /** Retorna a contagem atual sem incrementar. */
+    get(key: string, day: string): Promise<number> | number;
+    /** Reseta o armazenamento. */
+    reset(): Promise<void> | void;
+}
+/**
+ * Armazenamento em memória local (Map).
+ * Síncrono e ideal para servidores locais (CLI, NPM Free).
+ */
+export declare class MemoryRateLimiterStore implements RateLimiterStore {
+    readonly type: "memory";
+    private counts;
+    increment(key: string, day: string): number;
+    get(key: string, day: string): number;
+    reset(): void;
+}
+/**
+ * Armazenamento distribuído via Redis.
+ * Suporta Upstash / MCPize REST API via fetch nativo ou clientes TCP (ioredis / node-redis).
+ * Possui resiliência integrada: em caso de falha no Redis, faz fallback automático para memória.
+ */
+export declare class RedisRateLimiterStore implements RateLimiterStore {
+    readonly type: "redis";
+    private fallbackMemory;
+    private redisClient;
+    private clientPromise;
+    private isRest;
+    private restUrl?;
+    private restToken?;
+    private redisUrl?;
+    constructor(opts?: {
+        restUrl?: string;
+        restToken?: string;
+        redisUrl?: string;
+    });
+    private getClient;
+    increment(key: string, day: string, ttlSeconds: number): Promise<number>;
+    get(key: string, day: string): Promise<number>;
+    reset(): Promise<void>;
+}
+/**
+ * Detecta o backend de armazenamento mais apropriado baseado nas variáveis de ambiente.
+ */
+export declare function detectRateLimiterStoreFromEnv(): RateLimiterStore;
+/**
+ * Rate limiter por dia para os pacotes free ou deploy gerenciado.
+ * Armazena contagem em memória ou no Redis (detectado por variáveis de ambiente ou configurado via store).
+ */
+export declare class DailyRateLimiter {
+    private store;
+    private maxPerDay;
+    constructor(maxPerDayOrOpts?: number | {
+        maxPerDay?: number;
+        store?: RateLimiterStore;
+    });
+    private today;
+    /**
+     * Tenta consumir um request. Retorna true se permitido, false se limitado.
+     * Se usando store em memória, retorna boolean síncrono. Se no Redis, retorna Promise<boolean>.
+     */
+    tryConsume(key?: string): boolean | Promise<boolean>;
+    /**
+     * Retorna quantos requests restam hoje.
+     */
+    remaining(key?: string): number | Promise<number>;
+    /**
+     * Retorna o limite diário configurado.
+     */
+    get limit(): number;
+    /**
+     * Reseta a contagem (útil para testes).
+     */
+    reset(): void | Promise<void>;
+}
+/**
+ * Mensagem padrão de upgrade quando o rate limit é atingido.
+ */
+export declare function rateLimitMessage(toolName: string, limit: number): string;

package/dist/utils/rate-limiter.js

@@ -0,0 +1,263 @@
+/**
+ * Armazenamento em memória local (Map).
+ * Síncrono e ideal para servidores locais (CLI, NPM Free).
+ */
+export class MemoryRateLimiterStore {
+    type = "memory";
+    counts = new Map();
+    increment(key, day) {
+        const entry = this.counts.get(key);
+        if (!entry || entry.day !== day) {
+            this.counts.set(key, { count: 1, day });
+            return 1;
+        }
+        entry.count++;
+        return entry.count;
+    }
+    get(key, day) {
+        const entry = this.counts.get(key);
+        if (!entry || entry.day !== day)
+            return 0;
+        return entry.count;
+    }
+    reset() {
+        this.counts.clear();
+    }
+}
+/**
+ * Armazenamento distribuído via Redis.
+ * Suporta Upstash / MCPize REST API via fetch nativo ou clientes TCP (ioredis / node-redis).
+ * Possui resiliência integrada: em caso de falha no Redis, faz fallback automático para memória.
+ */
+export class RedisRateLimiterStore {
+    type = "redis";
+    fallbackMemory = new MemoryRateLimiterStore();
+    redisClient = null;
+    clientPromise = null;
+    isRest;
+    restUrl;
+    restToken;
+    redisUrl;
+    constructor(opts) {
+        this.restUrl = opts?.restUrl ?? process.env.UPSTASH_REDIS_REST_URL ?? process.env.REDIS_REST_URL;
+        this.restToken = opts?.restToken ?? process.env.UPSTASH_REDIS_REST_TOKEN ?? process.env.REDIS_REST_TOKEN;
+        this.redisUrl = opts?.redisUrl ?? process.env.REDIS_URL ?? process.env.MCPIZE_REDIS_URL;
+        this.isRest = Boolean(this.restUrl && this.restToken);
+    }
+    async getClient() {
+        if (this.isRest)
+            return null;
+        if (this.redisClient)
+            return this.redisClient;
+        if (this.clientPromise)
+            return this.clientPromise;
+        this.clientPromise = (async () => {
+            try {
+                try {
+                    // @ts-ignore
+                    const ioredis = await import("ioredis");
+                    const Redis = ioredis.default || ioredis.Redis || ioredis;
+                    const client = this.redisUrl
+                        ? new Redis(this.redisUrl)
+                        : new Redis({
+                            host: process.env.REDIS_HOST || "localhost",
+                            port: Number(process.env.REDIS_PORT || 6379),
+                            password: process.env.REDIS_PASSWORD,
+                        });
+                    client.on("error", (err) => {
+                        console.error(`[rate-limiter] Redis Client Error: ${err.message || err}`);
+                    });
+                    this.redisClient = client;
+                    return client;
+                }
+                catch {
+                    // @ts-ignore
+                    const nodeRedis = await import("redis");
+                    const createClient = nodeRedis.createClient || nodeRedis.default?.createClient;
+                    if (createClient) {
+                        const client = this.redisUrl
+                            ? createClient({ url: this.redisUrl })
+                            : createClient({
+                                socket: {
+                                    host: process.env.REDIS_HOST || "localhost",
+                                    port: Number(process.env.REDIS_PORT || 6379),
+                                },
+                                password: process.env.REDIS_PASSWORD,
+                            });
+                        client.on("error", (err) => {
+                            console.error(`[rate-limiter] node-redis Client Error: ${err.message || err}`);
+                        });
+                        await client.connect();
+                        this.redisClient = client;
+                        return client;
+                    }
+                }
+            }
+            catch {
+                // Ignora caso nenhum driver Redis esteja instalado
+            }
+            return null;
+        })();
+        return this.clientPromise;
+    }
+    async increment(key, day, ttlSeconds) {
+        const redisKey = `ratelimit:${day}:${key}`;
+        if (this.isRest && this.restUrl && this.restToken) {
+            try {
+                const incrRes = await fetch(`${this.restUrl}/INCR/${encodeURIComponent(redisKey)}`, {
+                    method: "POST",
+                    headers: { Authorization: `Bearer ${this.restToken}` },
+                    signal: AbortSignal.timeout(5000),
+                });
+                if (incrRes.ok) {
+                    const data = await incrRes.json();
+                    const count = Number(data.result || 1);
+                    if (count === 1) {
+                        await fetch(`${this.restUrl}/EXPIRE/${encodeURIComponent(redisKey)}/${ttlSeconds}`, {
+                            method: "POST",
+                            headers: { Authorization: `Bearer ${this.restToken}` },
+                            signal: AbortSignal.timeout(5000),
+                        }).catch(() => { });
+                    }
+                    return count;
+                }
+            }
+            catch (err) {
+                console.error(`[rate-limiter] Redis REST falhou, usando fallback em memória: ${err instanceof Error ? err.message : err}`);
+            }
+        }
+        try {
+            const client = await this.getClient();
+            if (client && typeof client.incr === "function") {
+                const count = await client.incr(redisKey);
+                if (count === 1 && typeof client.expire === "function") {
+                    await client.expire(redisKey, ttlSeconds);
+                }
+                return Number(count);
+            }
+        }
+        catch (err) {
+            console.error(`[rate-limiter] Redis TCP falhou, usando fallback em memória: ${err instanceof Error ? err.message : err}`);
+        }
+        return this.fallbackMemory.increment(key, day);
+    }
+    async get(key, day) {
+        const redisKey = `ratelimit:${day}:${key}`;
+        if (this.isRest && this.restUrl && this.restToken) {
+            try {
+                const res = await fetch(`${this.restUrl}/GET/${encodeURIComponent(redisKey)}`, {
+                    headers: { Authorization: `Bearer ${this.restToken}` },
+                    signal: AbortSignal.timeout(5000),
+                });
+                if (res.ok) {
+                    const data = await res.json();
+                    return Number(data.result || 0);
+                }
+            }
+            catch {
+                // Fallback
+            }
+        }
+        try {
+            const client = await this.getClient();
+            if (client && typeof client.get === "function") {
+                const val = await client.get(redisKey);
+                return Number(val || 0);
+            }
+        }
+        catch {
+            // ignore
+        }
+        return this.fallbackMemory.get(key, day);
+    }
+    async reset() {
+        this.fallbackMemory.reset();
+    }
+}
+/**
+ * Detecta o backend de armazenamento mais apropriado baseado nas variáveis de ambiente.
+ */
+export function detectRateLimiterStoreFromEnv() {
+    const hasRest = Boolean((process.env.UPSTASH_REDIS_REST_URL || process.env.REDIS_REST_URL) &&
+        (process.env.UPSTASH_REDIS_REST_TOKEN || process.env.REDIS_REST_TOKEN));
+    const hasTcp = Boolean(process.env.REDIS_URL ||
+        process.env.MCPIZE_REDIS_URL ||
+        process.env.REDIS_HOST);
+    if (hasRest || hasTcp) {
+        return new RedisRateLimiterStore();
+    }
+    return new MemoryRateLimiterStore();
+}
+/**
+ * Rate limiter por dia para os pacotes free ou deploy gerenciado.
+ * Armazena contagem em memória ou no Redis (detectado por variáveis de ambiente ou configurado via store).
+ */
+export class DailyRateLimiter {
+    store;
+    maxPerDay;
+    constructor(maxPerDayOrOpts) {
+        if (typeof maxPerDayOrOpts === "number") {
+            this.maxPerDay = maxPerDayOrOpts;
+            this.store = detectRateLimiterStoreFromEnv();
+        }
+        else if (typeof maxPerDayOrOpts === "object" && maxPerDayOrOpts !== null) {
+            this.maxPerDay = maxPerDayOrOpts.maxPerDay ?? 50;
+            this.store = maxPerDayOrOpts.store ?? detectRateLimiterStoreFromEnv();
+        }
+        else {
+            this.maxPerDay = 50;
+            this.store = detectRateLimiterStoreFromEnv();
+        }
+    }
+    today() {
+        return new Date().toISOString().split("T")[0];
+    }
+    /**
+     * Tenta consumir um request. Retorna true se permitido, false se limitado.
+     * Se usando store em memória, retorna boolean síncrono. Se no Redis, retorna Promise<boolean>.
+     */
+    tryConsume(key = "global") {
+        const day = this.today();
+        if (this.store.type === "memory") {
+            const current = this.store.increment(key, day, 86400);
+            return current <= this.maxPerDay;
+        }
+        return Promise.resolve(this.store.increment(key, day, 86400)).then((current) => current <= this.maxPerDay);
+    }
+    /**
+     * Retorna quantos requests restam hoje.
+     */
+    remaining(key = "global") {
+        const day = this.today();
+        if (this.store.type === "memory") {
+            const current = this.store.get(key, day);
+            return Math.max(0, this.maxPerDay - current);
+        }
+        return Promise.resolve(this.store.get(key, day)).then((current) => Math.max(0, this.maxPerDay - current));
+    }
+    /**
+     * Retorna o limite diário configurado.
+     */
+    get limit() {
+        return this.maxPerDay;
+    }
+    /**
+     * Reseta a contagem (útil para testes).
+     */
+    reset() {
+        return this.store.reset();
+    }
+}
+/**
+ * Mensagem padrão de upgrade quando o rate limit é atingido.
+ */
+export function rateLimitMessage(toolName, limit) {
+    return [
+        `⚠️ Limite diário atingido (${limit} consultas/dia no plano gratuito).`,
+        ``,
+        `Para uso ilimitado de ${toolName} + Pix, NFe e WhatsApp:`,
+        `→ npm install @brazil-mcp/bundle-pro`,
+        `→ Ou acesse: https://mcpize.com/brazil-mcp`,
+    ].join("\n");
+}
+//# 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":"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"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@brazil-mcp/cep",
+  "version": "1.0.0",
+  "description": "MCP server para consulta de CEP e cálculo de frete no Brasil",
+  "type": "module",
+  "bin": { "cep-mcp": "./dist/index.js" },
+  "main": "./dist/index.js",
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run tests/unit",
+    "test:flow": "vitest run tests/flow",
+    "test:all": "vitest run tests/unit tests/flow",
+    "test:integration": "vitest run tests/integration",
+    "test:coverage": "vitest run tests/unit tests/flow --coverage"
+  },
+  "keywords": ["mcp","mcp-server","brazil","cep","correios","frete","viacep"],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^3.2.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.2.0"
+  }
+}