factura-luz

Name: factura-luz
Author: ilopezluna

本地服务

ilopezluna.github.io金融数据22 周前更新

代码仓库访问官网

关于 factura-luz

factura-luz 是一个本地 MCP 服务，用于读取并解释含 CNMC 二维码的西班牙电费账单。它面向希望借助 Agent 理解账单的用户；账单处理不发起网络请求，并提供字段说明和功率调整计算方法资源。

主要功能

01读取 PDF 和图像账单
02提取 CNMC 二维码数据
03解释账单概念与字段
04提供功率调整方法资源

适用场景

01查看合同、用电量、价格和月均金额
02了解账单术语及其对应数值
03评估降低合同功率可能带来的节省

MCP 相关

该 MCP 服务向客户端提供 `read_invoice`、`explain_concept` 和 `list_concepts` 工具，以及二维码字段、术语表、合同类型和功率计算方法等资源，并提供 `entender-factura` 提示词。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "ilopezluna-factura-luz": {
      "command": "npx",
      "args": [
        "-y",
        "factura-luz-mcp"
      ]
    }
  }
}

启动命令npx -y factura-luz-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmfactura-luz-mcp0.1.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
qr_url	string	否	已解码的 CNMC 比价器 URL（https://comparador.cnmc.gob.es/comparador/QRE?...）。当 QR 码已在其他位置读取时使用。
invoice	object	否	之前调用 read_invoice 返回的 `invoice` 对象。传入此对象可在不重新读取文件的情况下再次分析同一账单，速度会快得多。
file_path	string	否	本机上账单文件的绝对路径（PDF、PNG、JPG、WEBP）。文件在本地读取，绝不会上传到任何位置。