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-11-09. Lee y explica facturas de la luz españolas (QR de la CNMC). Todo en local.

Factura Luz MCP server

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

Tools

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

FAQ

Questions

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.

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.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Factura Luz?

Does Factura Luz need an API key?

What transport does Factura Luz use?

When was Factura Luz last checked?

Documentation

Entiende tu factura

Stack

Requisitos

Desarrollo

Scripts

Estructura

Despliegue