MCP Marketplace
Sign inSign up
Back to Browse

Entiende Tu Factura MCP Server

by Ilopezluna
Developer ToolsUse Caution4.8MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

4.8
Use Caution4.8High Risk

This is a well-structured MCP server for parsing Spanish electricity invoices with proper authentication, secure handling of file data, and appropriate permissions. The code shows good security practices: all processing is client-side with no exfiltration, credentials are properly managed via environment variables, and dependencies are standard. Minor code quality observations around error handling and input validation do not materially impact security. Supply chain analysis found 12 known vulnerabilities in dependencies (2 critical, 6 high severity). Package verification found 1 issue (1 critical, 0 high severity).

6 files analyzed · 17 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

HTTP Network Access

Connects to external APIs or services over the internet.

Unverified package source

We couldn't verify that the installable package matches the reviewed source code. Proceed with caution.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-ilopezluna-factura-luz": {
      "args": [
        "-y",
        "entiende-tu-factura"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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

ScriptDescripción
npm run devServidor de desarrollo (Vite)
npm run buildTypecheck + build de producción a dist/
npm run previewSirve el build de producción
npm testTests (Vitest)
npm run typecheckComprobación de tipos sin emitir
npm run formatFormatea con Prettier
npm run validateformat:check + typecheck + test + MCP
npm run build:mcpCompila el servidor MCP a mcp/dist
npm run test:mcpTypecheck + tests del servidor MCP

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/<repo>/ como en un dominio propio.

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Paperclip

Free

by Paperclipai · Developer Tools

Trending hip-hop artist momentum scores across four cultural dimensions.

80.5K
Stars
0
Installs
10.0
Security
No ratings yet
Remote

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

80.0K
Stars
16
Installs
6.5
Security
No ratings yet
Local

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

180
Stars
748
Installs
8.0
Security
4.8
Local

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

-
Stars
131
Installs
10.0
Security
4.7
Local

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.

-
Stars
102
Installs
10.0
Security
5.0
Remote

MarkItDown

Free

by Microsoft · Content & Media

Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption

168.6K
Stars
93
Installs
4.2
Security
5.0
Local