Factura Luz

io.github.ilopezluna

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

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "io.github.ilopezluna-factura-luz": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add io.github.ilopezluna-factura-luz -- npx -y factura-luz-mcp@0.1.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.ilopezluna-factura-luz": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.1.0
Last checked: 2026-10-27

Stars: —
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Factura Luz?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Factura Luz need an API key?

No required environment variable is listed on this record.

What transport does Factura Luz use?

Factura Luz runs locally over stdio.

When was Factura Luz last checked?

Last checked 2026-10-27. Lee y explica facturas de la luz españolas (QR de la CNMC). Todo en local.

From the publisher

Documentation

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.com

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

Requisitos

Node.js (ver .nvmrc → 22.20.0)

Desarrollo

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

Scripts

Script	Descripción
`npm run dev`	Servidor de desarrollo (Vite)
`npm run build`	Typecheck + build de producción a `dist/`
`npm run preview`	Sirve el build de producción
`npm test`	Tests (Vitest)
`npm run typecheck`	Comprobación de tipos sin emitir
`npm run format`	Formatea con Prettier
`npm run validate`	`format:check` + `typecheck` + `test`

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

Solo extraction/extractor.ts depende del navegador; extraction/scan.ts y extraction/pdf.ts no tocan el DOM.

Despliegue

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

Factura Luz

io.github.ilopezluna

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

Productivity

Add to Cursor Add to VS Code Run on PlugMCP

GitHub npm Website

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "io.github.ilopezluna-factura-luz": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add io.github.ilopezluna-factura-luz -- npx -y factura-luz-mcp@0.1.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.ilopezluna-factura-luz": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.1.0
Last checked: 2026-10-27

Stars: —
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Factura Luz?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Factura Luz need an API key?

No required environment variable is listed on this record.

What transport does Factura Luz use?

Factura Luz runs locally over stdio.

When was Factura Luz last checked?

Last checked 2026-10-27. Lee y explica facturas de la luz españolas (QR de la CNMC). Todo en local.

From the publisher

Documentation

Entiende tu factura

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

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

Requisitos

Node.js (ver .nvmrc → 22.20.0)

Desarrollo

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

Scripts

Script	Descripción
`npm run dev`	Servidor de desarrollo (Vite)
`npm run build`	Typecheck + build de producción a `dist/`
`npm run preview`	Sirve el build de producción
`npm test`	Tests (Vitest)
`npm run typecheck`	Comprobación de tipos sin emitir
`npm run format`	Formatea con Prettier
`npm run validate`	`format:check` + `typecheck` + `test`

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

Solo extraction/extractor.ts depende del navegador; extraction/scan.ts y extraction/pdf.ts no tocan el DOM.