mcpField
E

Eleata Einvoice Mcp

本地服务
github.com/hernaninverso金融数据017 周前更新
代码仓库

关于 Eleata Einvoice Mcp

Eleata Einvoice Mcp 是面向编码 Agent 的 MCP 服务，可验证欧盟电子发票并解释校验错误。它结合托管校验 API 与离线错误代码参考，支持 Peppol BIS、XRechnung 和 Factur-X/ZUGFeRD 等格式。

主要功能

  1. 01校验支持的欧盟电子发票格式
  2. 02返回规则标识和修复建议
  3. 03列出当前支持的格式
  4. 04离线解释错误代码

适用场景

  1. 01提交前校验 XRechnung 发票
  2. 02诊断 FatturaPA 校验错误
  3. 03查询支持的发票格式

MCP 相关

该 MCP 服务提供发票校验、格式列表和错误代码解释工具。发票校验使用托管的 eleata API；格式查询和错误解释可离线使用。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "eleata-einvoice": {
      "command": "npx",
      "args": [
        "-y",
        "eleata-einvoice-mcp"
      ],
      "env": {
        "EINVOICE_API_KEY": "<EINVOICE_API_KEY>"
      }
    }
  }
}
启动命令npx -y eleata-einvoice-mcp
需要配置的环境变量
EINVOICE_API_KEY密钥Free API key for the eleata e-invoice validation backend (https://eleata.io/signup/)

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

安装包
npmeleata-einvoice-mcp0.1.1

工具

3

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

参数类型必填说明
formatenum否格式提示。默认值：auto（服务器会检测 XML 或 PDF 以及配置文件）。auto | peppol-bis-3 | en16931-ubl | en16931-cii | xrechnung-ubl | xrechnung-cii | factur-x | ubl | cii
is_pdfboolean否如果 `content` 是 base64 编码的 PDF（Factur-X/ZUGFeRD），请设为 true。默认值为 false。
contentstring是要验证的发票。对于 XML 格式，提供原始 XML 文本。对于 Factur-X / ZUGFeRD PDF，提供 base64 编码的 PDF 字节（设置 is_pdf=true）。

详细介绍

eleata 电子发票 MCP 服务

直接通过 AI 编码 Agent（Claude、Cursor、Copilot，……）验证欧盟电子发票并解释验证错误代码。它封装了托管的 eleata 验证 API，并内置离线错误代码参考。

绝不提交有问题的发票。当你询问 Agent“这个 FatturaPA / XRechnung / Peppol 文件是否有效？”时，它会运行官方 Schematron 规则，并返回规则 ID 及修复方法——在收到拒绝（SdI scarto、Chorus Pro 拒绝、KSeF 错误）之前就发现问题。

工具

工具功能API 密钥
validate_einvoice验证一张发票（Peppol BIS 3.0、EN 16931 UBL/CII、XRechnung 3.0.x、Factur-X/ZUGFeRD、UBL、CII）。返回有效/无效状态，以及每条规则的 ID、说明和修复方法。必需
list_formats列出 eleata 当前支持验证的格式及路线图。无
explain_error_code用通俗易懂的语言解释一个错误代码（例如 00400、BR-DE-21），并提供修复方法。可离线使用。无

设置

  1. 在 https://eleata.io/signup/ 获取免费 API 密钥（每月 200 次验证，无需银行卡）。
  2. 将此服务添加到 Agent 的 MCP 配置中。
Claude Desktop / Claude Code（claude_desktop_config.json 或 .mcp.json）
{
  "mcpServers": {
    "eleata-einvoice": {
      "command": "npx",
      "args": ["-y", "eleata-einvoice-mcp"],
      "env": { "EINVOICE_API_KEY": "your_free_key_here" }
    }
  }
}
Cursor（~/.cursor/mcp.json）

与上面的配置块相同。

示例提示词

  • “验证这个 XRechnung 文件，并告诉我需要修复什么”（粘贴 XML）
  • “FatturaPA 错误 00400 是什么意思？如何修复？”
  • “你现在能验证哪些电子发票格式？”

隐私

validate_einvoice 会将你提供的发票发送到托管的 eleata API 进行验证。list_formats 和 explain_error_code 在本地/离线运行（内置错误代码参考）。请参阅 https://eleata.io/privacy/.

链接

采用 MIT 许可。Schematron 引擎：Mustang / phive。Schematron 规则来自 CEN、OpenPeppol、KoSIT。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。