pdfvera

Name: pdfvera
Author: pdfvera.com

本地服务

pdfvera.com金融数据03 天前更新

代码仓库访问官网

关于 pdfvera

pdfvera 将德国 PDF 发票转换为电子发票，并把巴西银行对账单转换为 OFX、CSV 或 Excel，面向处理这些文件的财务人员。它在本机读取文件，通过 pdfvera API 处理，并将结果写回磁盘。

主要功能

01发票转为 XRechnung 和 ZUGFeRD
02按 KoSIT 规则校验并生成报告
03对账单转为 OFX、CSV 和 Excel
04校验对账单余额后写入文件
05查询套餐与月度额度

适用场景

01将德国发票转换为电子发票
02不消耗额度预检发票文件
03导出巴西银行对账单数据
04检查当月剩余转换额度

MCP 相关

本地 MCP 服务让 AI 助手调用 pdfvera API 转换文件。它向 MCP 客户端提供发票转换、对账单转换和用量查询工具。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "com-pdfvera-pdfvera": {
      "command": "npx",
      "args": [
        "-y",
        "pdfvera-mcp"
      ],
      "env": {
        "PDFVERA_API_KEY": "<PDFVERA_API_KEY>"
      }
    }
  }
}

启动命令npx -y pdfvera-mcp

需要配置的环境变量

PDFVERA_API_KEY密钥API key from your pdfvera account

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

安装包

npmpdfvera-mcp1.1.0stdio

工具

收录的工具列表 · 更新于 3 天前

参数	类型	必填	说明
role	enum	否	用户是开具方（issuer）还是接收方（recipient）；仅影响问题的措辞issuer \| recipient
answers	object	否	缺失字段的值，以 questions[].field 为键，例如 {"buyer_reference": "04011000-12345-06"}
pdf_path	string	是	此计算机上 PDF 发票的路径
check_only	boolean	否	仅检查，不写入文件且不消耗配额
output_dir	string	否	结果文件的文件夹；默认值：PDF 所在文件夹
corrections	object	否	修正从 PDF 中读取的值，以 found[].edit[].key 为键，例如 {"fix:number": "RE-2026-0042"}

详细介绍

pdfvera MCP 服务

让 Claude 和 Cursor 等 AI 助手通过 pdfvera 转换文档：

将德国 PDF 发票转换为电子发票： XRechnung 3.0（UBL 和 CII）以及 ZUGFeRD PDF（EN 16931），并依据 KoSIT 官方规则进行检查，同时生成检查报告。如果缺少必填数据，助手会向你询问。
将巴西银行对账单 PDF（extrato bancário）转换为 OFX、CSV 和 Excel： 生成适用于 Domínio、Alterdata、Conta Azul 或 Omie 的 OFX 文件。只有当条目合计与对账单上打印的余额一致时，才会写入文件。

服务在你的计算机上运行。它会从你的磁盘读取 PDF，使用你的 API 密钥将其发送到 pdfvera API，并在 PDF 所在目录中写入结果文件。

要求

pdfvera 套餐。每个套餐都包含 API 和此服务，且每月额度与网站相同（Preise、Preços）。仅检查 PDF 而不写入文件（check_only）是免费的。
API 密钥，可在你的 pdfvera 账户中创建（Konto、Conta）。
Node.js 18 或更高版本（Claude Desktop 扩展无需此项）。

安装

Claude Code

claude mcp add pdfvera -e PDFVERA_API_KEY=pv_YOUR_KEY -- npx -y pdfvera-mcp@latest

也可以作为插件安装。该插件不包含 MCP 服务；它是一个技能，可让 Claude 使用 curl 调用 pdfvera API。它会从 PDFVERA_API_KEY 读取密钥，因此请先将 { "env": { "PDFVERA_API_KEY": "pv_YOUR_KEY" } } 添加到 ~/.claude/settings.json，然后运行：

/plugin marketplace add pdfvera/pdfvera-mcp
/plugin install pdfvera@pdfvera

Cursor（~/.cursor/mcp.json）和其他 MCP 客户端

{
  "mcpServers": {
    "pdfvera": {
      "command": "npx",
      "args": ["-y", "pdfvera-mcp@latest"],
      "env": { "PDFVERA_API_KEY": "pv_YOUR_KEY" }
    }
  }
}

Claude Desktop： 下载 pdfvera.mcpb，打开并输入 API 密钥。

工具

工具	功能
`convert_invoice`	将 PDF 发票转换为 XRechnung（UBL、CII）、ZUGFeRD 和检查报告。以问题形式返回缺失字段；答案和更正内容会在下一次调用时提交。
`convert_bank_statement`	检查余额后，将巴西银行对账单 PDF 转换为 OFX、CSV 和 Excel。支持受密码保护的 PDF（`password` 或 `cpf`）。
`get_usage`	查看你的套餐以及每月额度的使用情况。

每转换一份文档，都会扣除一次每月额度。同一份 PDF 在同一个月内再次转换不会扣除额度；check_only 永远不会扣除额度。

示例提示词

“将 ~/Rechnungen/RE-2026-0042.pdf 转换为 XRechnung。这是我发送给公共机构的一张发票。”
“检查 ~/Rechnungen/November 中的所有 PDF 是否都能转换为电子发票，不要使用我的额度。”
“Converte o extrato ~/Downloads/extrato-itau-outubro.pdf em OFX para o Domínio.”
“这份对账单 PDF 受密码保护；账户持有人的 CPF 是 123.456.789-09。请重试。”
“这个月我还剩多少次转换额度？”

隐私政策

此程序不会存储任何内容。它会通过 HTTPS 将你指定的 PDF 和你的答案发送到 pdfvera.com，并将结果写入你的磁盘。pdfvera 如何处理上传的文档，请参阅隐私政策：Datenschutzerklärung（发票）和 Política de privacidade（银行对账单）。简而言之：发票 PDF 在欧盟境内处理，且不会留存；通过 API 发送的银行对账单 PDF 绝不会留存。系统只存储每份已转换 PDF 的哈希值，因此同一份文档不会被重复计数。pdfvera 的规则无法读取的银行对账单会发送到 Anthropic API，以读取其中的条目；Anthropic 会在 30 天内删除这些数据，且不会用其进行训练。

故障排除

“No pdfvera API key”：在服务配置中设置 PDFVERA_API_KEY（对于插件：在 ~/.claude/settings.json 的 env 下设置），然后重启助手。
“The API key is missing, wrong or revoked”：在你的 pdfvera 账户中创建一个新密钥。
“no active plan” / “quota is used up”：文件需要套餐；check_only 无需套餐即可使用。
助手看不到工具：检查 node --version 输出是否为 18 或更高版本，然后重启助手。
未转换，缺少字段：助手应询问你所列出的字段；你也可以在 pdfvera.com 上填写。