@nubiia/mcp-freematica 0.6.1

package/dist/tools/proveedores.js

@@ -0,0 +1,122 @@
+import { z } from 'zod';
+import { FreematicaError } from '../clients/base-client.js';
+import { PaginationSchema } from '../schemas/pagination.js';
+import { error, ok, okList } from './helpers.js';
+const LIST_TOOL_NAME = 'freematica_list_proveedores';
+const GET_TOOL_NAME = 'freematica_get_proveedor';
+const LIST_DESCRIPTION = [
+    'Devuelve la lista paginada de proveedores de Freemática.',
+    '',
+    'Cada item contiene campos como COD_PRO (código), COD_GRUPO_PRO (grupo), NIF, NOMBRE_PRO (nombre),',
+    'FECHA_BAJA (baja del proveedor), CMP_TIPO_IDENT (tipo identificador), COD_PROVINCIA, COD_PAIS,',
+    'más `idReg` opaco para el endpoint singular.',
+    '',
+    'Paginación 1-indexed.',
+    '',
+    'El filtro `activo` es un booleano: true = FECHA_BAJA nula (proveedores activos);',
+    'false = FECHA_BAJA informada (dados de baja).',
+    '',
+    'El filtro `nombre` realiza búsqueda parcial mediante operador FIQL =lk= (LIKE).',
+].join('\n');
+const GET_DESCRIPTION = [
+    'Devuelve el detalle completo de un proveedor.',
+    '',
+    'El parámetro `id` DEBE ser el campo `idReg` (string opaco base64) que aparece en los items de',
+    'freematica_list_proveedores. NO usar COD_PRO ni otro código natural.',
+].join('\n');
+const LIST_SCHEMA = {
+    ...PaginationSchema,
+    codProveedor: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código natural del proveedor (COD_PRO en Freemática).'),
+    grupoProveedor: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de grupo de proveedores (COD_GRUPO_PRO en Freemática).'),
+    nif: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('NIF / CIF del proveedor (NIF en Freemática). Búsqueda exacta.'),
+    nombre: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Nombre del proveedor (NOMBRE_PRO). Búsqueda parcial — se usa operador FIQL =lk= (LIKE). ' +
+        'Ejemplo: "García" devuelve todos los proveedores cuyo nombre contenga "García".'),
+    activo: z
+        .boolean()
+        .optional()
+        .describe('Filtra por estado del proveedor. true = sin fecha de baja (activos); ' +
+        'false = con fecha de baja (dados de baja). FECHA_BAJA en Freemática.'),
+    tipoIdent: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Tipo de identificador fiscal (CMP_TIPO_IDENT en Freemática). Enum del API.'),
+    codProvincia: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de provincia (COD_PROVINCIA en Freemática).'),
+    codPais: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de país (COD_PAIS en Freemática).'),
+};
+/**
+ * Registra las tools de proveedores en el servidor MCP.
+ *
+ * Tools registradas:
+ * - `freematica_list_proveedores`: lista paginada con filtros FIQL (incluye búsqueda parcial por nombre
+ *   con =lk= y filtro activo/inactivo vía FECHA_BAJA).
+ * - `freematica_get_proveedor`: detalle por idReg opaco.
+ *
+ * @param server - Instancia del servidor MCP.
+ * @param client - Cliente Freemática autenticado.
+ */
+export function registerProveedoresTools(server, client) {
+    server.tool(LIST_TOOL_NAME, LIST_DESCRIPTION, LIST_SCHEMA, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ page, items, codProveedor, grupoProveedor, nif, nombre, activo, tipoIdent, codProvincia, codPais, }) => {
+        try {
+            const result = await client.listProveedores({
+                page,
+                items,
+                codProveedor,
+                grupoProveedor,
+                nif,
+                nombre,
+                activo,
+                tipoIdent,
+                codProvincia,
+                codPais,
+            });
+            return okList({ items: result.items, total: result.total, page, itemsPerPage: items });
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    server.tool(GET_TOOL_NAME, GET_DESCRIPTION, {
+        id: z
+            .string()
+            .min(1)
+            .describe('idReg opaco del proveedor (campo "idReg" en los items de freematica_list_proveedores).'),
+    }, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ id }) => {
+        try {
+            const proveedor = await client.getProveedor(id);
+            return ok(proveedor);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+}
+//# sourceMappingURL=proveedores.js.map

package/dist/tools/proveedores.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proveedores.js","sourceRoot":"","sources":["../../src/tools/proveedores.ts"],"names":[],"mappings":"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"}

package/dist/transports/http.d.ts

@@ -0,0 +1,12 @@
+import express from 'express';
+import type { FreematicaClient } from '../clients/freematica-client.js';
+export interface HttpTransportConfig {
+    port: number;
+    client: FreematicaClient;
+    allowedOrigins: string;
+}
+export interface HttpAppResult {
+    app: express.Application;
+    shutdown: () => Promise<void>;
+}
+export declare function createHttpApp(config: HttpTransportConfig): Promise<HttpAppResult>;

package/dist/transports/http.js

@@ -0,0 +1,110 @@
+import express from 'express';
+import cors from 'cors';
+import rateLimit from 'express-rate-limit';
+import { randomUUID } from 'node:crypto';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js';
+import { createFreematicaServer } from '../server.js';
+const SESSION_TTL_MS = 30 * 60 * 1000; // 30 min
+export async function createHttpApp(config) {
+    const app = express();
+    const sessions = new Map();
+    const origins = config.allowedOrigins === '*'
+        ? true
+        : config.allowedOrigins.split(',').map((s) => s.trim());
+    app.use(cors({
+        origin: origins,
+        exposedHeaders: ['Mcp-Session-Id'],
+        allowedHeaders: ['Content-Type', 'Mcp-Session-Id', 'Authorization'],
+    }));
+    app.use(express.json({ limit: '1mb' }));
+    const mcpRateLimit = rateLimit({
+        windowMs: 60_000,
+        limit: 120,
+        standardHeaders: true,
+        legacyHeaders: false,
+    });
+    app.get('/health', (_req, res) => {
+        res.json({ status: 'ok', version: '0.4.1', sessions: sessions.size });
+    });
+    // POST /mcp — JSON-RPC handler
+    app.post('/mcp', mcpRateLimit, async (req, res) => {
+        const sessionId = req.headers['mcp-session-id'];
+        let entry = sessionId ? sessions.get(sessionId) : undefined;
+        if (!entry) {
+            if (!isInitializeRequest(req.body)) {
+                res.status(400).json({
+                    jsonrpc: '2.0',
+                    error: { code: -32000, message: 'No session: send initialize first' },
+                    id: null,
+                });
+                return;
+            }
+            const transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: () => randomUUID(),
+                onsessioninitialized: (sid) => {
+                    sessions.set(sid, { transport, createdAt: Date.now() });
+                },
+            });
+            transport.onclose = () => {
+                if (transport.sessionId)
+                    sessions.delete(transport.sessionId);
+            };
+            const server = createFreematicaServer({ client: config.client });
+            await server.connect(transport);
+            await transport.handleRequest(req, res, req.body);
+            return;
+        }
+        await entry.transport.handleRequest(req, res, req.body);
+    });
+    // GET /mcp — SSE stream
+    app.get('/mcp', mcpRateLimit, async (req, res) => {
+        const sessionId = req.headers['mcp-session-id'];
+        const entry = sessionId ? sessions.get(sessionId) : undefined;
+        if (!entry) {
+            res.status(400).send('Invalid or missing Mcp-Session-Id');
+            return;
+        }
+        await entry.transport.handleRequest(req, res);
+    });
+    // DELETE /mcp — terminate session
+    app.delete('/mcp', mcpRateLimit, async (req, res) => {
+        const sessionId = req.headers['mcp-session-id'];
+        const entry = sessionId ? sessions.get(sessionId) : undefined;
+        if (!entry) {
+            res.status(404).send('Session not found');
+            return;
+        }
+        await entry.transport.handleRequest(req, res);
+        sessions.delete(sessionId);
+    });
+    // Background pruning of orphaned sessions
+    const pruneInterval = setInterval(() => {
+        const now = Date.now();
+        for (const [sid, entry] of sessions.entries()) {
+            if (now - entry.createdAt > SESSION_TTL_MS) {
+                try {
+                    void entry.transport.close();
+                }
+                catch {
+                    /* ignore */
+                }
+                sessions.delete(sid);
+            }
+        }
+    }, 5 * 60 * 1000);
+    const shutdown = async () => {
+        clearInterval(pruneInterval);
+        for (const entry of sessions.values()) {
+            try {
+                await entry.transport.close();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        sessions.clear();
+    };
+    return { app, shutdown };
+}
+//# sourceMappingURL=http.js.map

package/dist/transports/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/transports/http.ts"],"names":[],"mappings":"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"}

package/dist/transports/stdio.d.ts

@@ -0,0 +1,12 @@
+import type { FreematicaClient } from '../clients/freematica-client.js';
+export interface StartStdioOptions {
+    client: FreematicaClient;
+}
+/**
+ * Arranca el MCP server sobre el transport stdio.
+ *
+ * Mantiene el proceso vivo mientras el transport esté abierto (Claude
+ * Desktop / Claude Code cierran stdin cuando terminan, lo que dispara
+ * el `onclose` del transport y libera el proceso).
+ */
+export declare function startStdio(opts: StartStdioOptions): Promise<void>;

package/dist/transports/stdio.js

@@ -0,0 +1,15 @@
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createFreematicaServer } from '../server.js';
+/**
+ * Arranca el MCP server sobre el transport stdio.
+ *
+ * Mantiene el proceso vivo mientras el transport esté abierto (Claude
+ * Desktop / Claude Code cierran stdin cuando terminan, lo que dispara
+ * el `onclose` del transport y libera el proceso).
+ */
+export async function startStdio(opts) {
+    const server = createFreematicaServer({ client: opts.client });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=stdio.js.map

package/dist/transports/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../src/transports/stdio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAMtD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAuB;IACtD,MAAM,MAAM,GAAG,sBAAsB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}

package/dist/types/api-envelope.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Wrapper universal que devuelve el API REST de Freemática en TODAS las
+ * respuestas. El `BaseClient` desempaqueta automáticamente este envelope
+ * y propaga `data` al método caller.
+ *
+ * `errorCode` viene como string (p.ej. "200", "404", "500"). Si es distinto
+ * de "200" el `BaseClient` lanza `FreematicaError` con un código mapeado.
+ */
+export interface FreematicaEnvelope<T> {
+    errorCode: string;
+    errorMessage: string;
+    data: T;
+}
+/**
+ * Shape del campo `data` en endpoints de listado.
+ *
+ * `total` viene como string del API (típicamente "2007"). El método cliente
+ * lo convierte a `number` antes de exponerlo.
+ *
+ * `rowHeight` es metadata interno del API (parece UI-related); el cliente
+ * lo descarta.
+ */
+export interface FreematicaListData<T> {
+    total: string;
+    items: T[];
+    rowHeight: number;
+}

package/dist/types/api-envelope.js

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

package/dist/types/api-envelope.js.map

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

package/dist/types/clientes.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Cliente devuelto por Freemática.
+ *
+ * El shape exacto tiene ~87 campos en mayúsculas (`COD_CLI`, `NOMBRE_CLI`,
+ * `NIF`, `FECHA_ALTA`, etc.) más un campo `idReg` opaco (base64) que es la
+ * clave para los endpoints singulares. Se mantiene como `Record<string, unknown>`
+ * hasta que tengamos un caso de uso que justifique tipar campos concretos.
+ */
+export type Cliente = Record<string, unknown>;

package/dist/types/clientes.js

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

package/dist/types/clientes.js.map

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

package/dist/types/contactos-clientes.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Contacto de cliente devuelto por Freemática.
+ *
+ * Mismo patrón que `Cliente`: campos en mayúsculas + `idReg` opaco. Sin
+ * tipado fuerte por ahora.
+ */
+export type ContactoCliente = Record<string, unknown>;

package/dist/types/contactos-clientes.js

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

package/dist/types/contactos-clientes.js.map

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

package/dist/types/contratos.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Response object for GET /pvss/v2/contratos-servicios-material.
+ *
+ * The exact shape is not documented in the Postman collection. The type is
+ * declared as a loose record until we have access to real API responses;
+ * tighten it then.
+ */
+export type VoContratosServMatAsignado = Record<string, unknown>;

package/dist/types/contratos.js

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

package/dist/types/contratos.js.map

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

package/dist/types/master-data.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Item de un catálogo de datos maestros de Freemática.
+ *
+ * El shape exacto varía por catálogo (algunos exponen `{ idreg, codigo, nombre }`,
+ * otros tienen campos específicos). Se mantiene como `Record<string, unknown>`
+ * hasta que se vean respuestas reales y se decida si tiparlos por catálogo o
+ * con un shape común mínimo.
+ */
+export type MasterDataItem = Record<string, unknown>;

package/dist/types/master-data.js

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

package/dist/types/master-data.js.map

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

package/dist/types/oportunidades-negocio.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Oportunidad de negocio devuelta por Freemática (módulo pcrm).
+ *
+ * ~33 campos: `COD_CLI`, `COD_ESTADO_OPOR`, `COD_ETAPA_OPOR`, `NOMBRE`,
+ * `VALOR`, `ID_OPORTUNIDAD`, etc. Más un `idReg` opaco para el endpoint
+ * singular.
+ */
+export type OportunidadNegocio = Record<string, unknown>;

package/dist/types/oportunidades-negocio.js

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

package/dist/types/oportunidades-negocio.js.map

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

package/dist/utils/size-guardrail.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Utilidades de guardrail de tamaño para respuestas del API de Freemática.
+ *
+ * Centraliza la lógica de lectura del límite de tamaño de respuesta para
+ * evitar duplicación entre el cliente HTTP y las tools MCP.
+ *
+ * @module size-guardrail
+ */
+/**
+ * Lee el límite de respuesta en MB desde la variable de entorno
+ * `FREEMATICA_MAX_RESPONSE_SIZE_MB`. Si no está definida o es inválida,
+ * devuelve el default de 10 MB.
+ *
+ * Reglas de validación:
+ * - Debe ser un número.
+ * - Debe ser un número entero.
+ * - Debe estar en el rango [1, 500].
+ * Si cualquiera de esas condiciones falla, se devuelve el default de 10 MB.
+ *
+ * @returns Límite en megabytes (entero en [1, 500]).
+ */
+export declare function loadMaxResponseSizeMb(): number;

package/dist/utils/size-guardrail.js

@@ -0,0 +1,31 @@
+/**
+ * Utilidades de guardrail de tamaño para respuestas del API de Freemática.
+ *
+ * Centraliza la lógica de lectura del límite de tamaño de respuesta para
+ * evitar duplicación entre el cliente HTTP y las tools MCP.
+ *
+ * @module size-guardrail
+ */
+/**
+ * Lee el límite de respuesta en MB desde la variable de entorno
+ * `FREEMATICA_MAX_RESPONSE_SIZE_MB`. Si no está definida o es inválida,
+ * devuelve el default de 10 MB.
+ *
+ * Reglas de validación:
+ * - Debe ser un número.
+ * - Debe ser un número entero.
+ * - Debe estar en el rango [1, 500].
+ * Si cualquiera de esas condiciones falla, se devuelve el default de 10 MB.
+ *
+ * @returns Límite en megabytes (entero en [1, 500]).
+ */
+export function loadMaxResponseSizeMb() {
+    const raw = process.env['FREEMATICA_MAX_RESPONSE_SIZE_MB'];
+    if (raw === undefined || raw === '')
+        return 10;
+    const parsed = Number(raw);
+    if (isNaN(parsed) || !Number.isInteger(parsed) || parsed < 1 || parsed > 500)
+        return 10;
+    return parsed;
+}
+//# sourceMappingURL=size-guardrail.js.map

package/dist/utils/size-guardrail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"size-guardrail.js","sourceRoot":"","sources":["../../src/utils/size-guardrail.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAC3D,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,GAAG;QAAE,OAAO,EAAE,CAAC;IACxF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "@nubiia/mcp-freematica",
+  "version": "0.6.1",
+  "description": "MCP server for Freemática REST API (consumed by Claude via Nubiia)",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-freematica": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "lint": "eslint src tests",
+    "lint:fix": "eslint src tests --fix",
+    "format": "prettier --write src tests",
+    "typecheck": "tsc --noEmit -p tsconfig.test.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepack": "npm run build",
+    "prepare": "husky"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nubiia-dev/mcp-freematica.git"
+  },
+  "bugs": {
+    "url": "https://github.com/nubiia-dev/mcp-freematica/issues"
+  },
+  "homepage": "https://github.com/nubiia-dev/mcp-freematica#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "freematica",
+    "nubiia"
+  ],
+  "author": "Nubiia",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "axios": "^1.7.0",
+    "cors": "^2.8.5",
+    "express": "^4.21.0",
+    "express-rate-limit": "^8.3.1",
+    "pino": "^10.3.1",
+    "uuid": "^14.0.0",
+    "zod": "^3.23.8"
+  },
+  "lint-staged": {
+    "*.{ts,js}": [
+      "eslint --fix"
+    ],
+    "*.{json,md}": [
+      "prettier --write"
+    ]
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.19",
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.10.0",
+    "@types/uuid": "^10.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "@vitest/coverage-v8": "^3.2.6",
+    "@vitest/ui": "^3.2.6",
+    "dotenv": "^16.0.0",
+    "eslint": "^9.0.0",
+    "fast-check": "^4.8.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.4.0",
+    "nock": "^13.5.0",
+    "pino-pretty": "^13.1.3",
+    "prettier": "^3.3.0",
+    "tsx": "^4.6.0",
+    "typescript": "^5.3.0",
+    "vitest": "^3.2.6"
+  }
+}