Factura Luz MCP server

by ilopezluna·io.github.ilopezluna/factura-luz·v0.1.0·2 stars

No reviews yet

Lee y explica facturas de la luz españolas (QR de la CNMC). Todo en local.

A92/100grade A

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

A92/100

full report

Adoption

Growing

2 stars30 downloads/wk

Reviews

Write one

Nobody has reviewed Factura Luz yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Factura Luz tools

No tool declarations could be read from the package source. They show once the server is installed.

Public scan report

scanner v0.1.10 · 2026-10-14 · same rubric, same numbers if you re-run it

no findings

Code scan2 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitylocal package, no credentials required12/15
Maintenancelast push 11 days ago15/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Overall 92/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Factura Luz compares

Against every graded Productivity MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 92/100; higher than 90% of 1,299 Productivity servers
GitHub stars: 2; more than 60% of 854 Productivity servers
Downloads a week: 30; more than 14% of 427 Productivity servers with a package

Install Factura Luz in Claude Code, Cursor or VS Code

Runs npx -y factura-luz-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add factura-luz -- npx -y factura-luz-mcp

Add to Cursor

What the publisher says

From the Factura Luz repository's README, as published. We do not edit it. Read it on GitHub

Entiende tu factura

Aplicación 100% cliente (sin backend) que explica tu factura de la luz. Sube tu factura (PDF o imagen), el navegador lee el código QR de la CNMC y te muestra un desglose claro de lo que estás pagando: potencia, energía, impuestos y contrato.

👉 Pruébala en vivo: entiende-tu-factura

Privacidad: todo el procesamiento ocurre en tu navegador. Tu factura nunca

se envía a ningún servidor.

Stack

React 19 + Vite + TypeScript
Tailwind CSS v4
Extracción de QR/PDF con jsqr + pdfjs-dist
Tests con Vitest

Para agentes

Si prefieres que sea tu agente quien lea la factura, hay un servidor MCP que expone la misma lógica: factura-luz-mcp. Se ejecuta en local, así que la factura tampoco sale de tu ordenador.

claude plugin marketplace add ilopezluna/entiende-tu-factura
claude plugin install factura-luz@entiende-tu-factura

O, si prefieres solo el servidor MCP sin el comando /entender:

claude mcp add factura-luz -- npx -y factura-luz-mcp

Más servicios

Si quieres comparar ofertas y ahorrar en tu factura, visita InvoiceDown.

Requisitos

Node.js (ver .nvmrc → 22.20.0)

Desarrollo

npm install
npm run dev        # http://localhost:5173

Scripts

Estructura

src/
├── lib/cnmc/          # Extracción y cálculo (lógica CNMC propia)
│   ├── extraction/    # scan/pdf (agnósticos) + extractor (navegador) + validadores
│   ├── parsing/       # parseo de parámetros del QR
│   ├── types/         # QrParameters + enums
│   ├── content/       # vocabulario y explicaciones en español
│   ├── format/        # formateo de números en es-ES
│   ├── utils/         # cálculo de costes y análisis de potencia
│   └── __tests__/     # tests de lógica pura
├── styles/            # Tailwind v4 + design tokens
├── App.tsx
└── main.tsx
mcp/                   # servidor MCP (paquete npm factura-luz-mcp)

src/lib/cnmc/ es compartido: la web y el servidor MCP calculan con el mismo código. Solo extraction/extractor.ts depende del navegador; extraction/scan.ts y extraction/pdf.ts no tocan el DOM y se reutilizan en Node.

Despliegue

Push a main despliega automáticamente a GitHub Pages (.github/workflows/deploy.yml), disponible en https://ilopezluna.github.io/entiende-tu-factura/. El base de Vite es relativo (./), por lo que funciona tanto en usuario.github.io// como en un dominio propio.

Nothing above is checked by us. What we check is on the safety report.

Factura Luz: common questions

Is Factura Luz MCP server safe?: Yes, by our scan: it is graded A (92/100). Read the Factura Luz safety report
How do I install Factura Luz?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Factura Luz need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Factura Luz maintained?: The last commit was 32 days ago (2026-10-03). The latest release is v0.1.0.
How does Factura Luz compare with other Productivity MCP servers?: safety score 92/100 (higher than 90% of 1,299 Productivity servers); github stars 2 (more than 60% of 854 Productivity servers); downloads a week 30 (more than 14% of 427 Productivity servers with a package). Full comparison.