invovate-mcp-server

Invovate MCP 服务

Invovate MCP 服务是一款免费、无需注册的发票 MCP 服务，可供 Claude、Cursor 和其他 MCP 客户端使用——它通过 Invovate invoice API 生成 PDF、JSON 和 UBL 2.1 格式的发票。

AI Agent 可通过 Invovate invoice API 生成 11 种语言的 PDF、JSON 和 UBL 2.1 发票 （包括从右向左书写的阿拉伯语，以及日语、印地语和西里尔字母语言）。支持 Claude Desktop、 Cursor、Windsurf 和任何兼容 MCP 的客户端。

JSON 计算无需 API 密钥；生成 PDF/UBL 需要免费密钥。

工具

工具	功能	是否需要密钥
calculate_invoice_totals	计算小计、折扣、税费、运费、定金、总额和应付余额——不生成文件。	否
generate_invoice_pdf	生成 PDF。返回有效期为 7 天的托管链接（适用于聊天），或者在提供 save_path 时写入文件。	是
generate_invoice_ubl	生成 UBL 2.1 XML（仅用于互操作性/存档——并非受监管的电子发票）。	是
get_invoice_capabilities	列出支持的语言、模板、货币和功能。	否

获取免费 API 密钥

在 https://invovate.com/auth 注册——密钥以 inv_ 开头。免费套餐， 无需信用卡。（calculate_invoice_totals 无需密钥即可使用；生成 PDF、UBL、QR 码和托管链接需要免费密钥。）

安装

Claude Desktop

将以下内容添加到 claude_desktop_config.json （macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json， Windows 上为 %APPDATA%\Claude\claude_desktop_config.json）：

{
  "mcpServers": {
    "invovate": {
      "command": "npx",
      "args": ["-y", "invovate-mcp-server"],
      "env": { "INVOVATE_API_KEY": "inv_your_key_here" }
    }
  }
}

重启 Claude Desktop。然后询问：“为 Acme BV 开具发票，向 Globex 收取 3 天咨询服务费，每天 €900，税率为 21% VAT，使用英语，并提供 PDF。”

Cursor / Windsurf

将相同的代码块添加到 MCP 配置中（Cursor 对应 ~/.cursor/mcp.json，或者添加到 Windsurf MCP 设置中）。

从源码运行（npm 发布前）

git clone https://github.com/LightSpeedPlusOne/invovate-mcp-server.git
cd invovate-mcp-server && npm install
INVOVATE_API_KEY=inv_your_key node src/index.js

……并将客户端指向它：

{
  "mcpServers": {
    "invovate": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/src/index.js"],
      "env": { "INVOVATE_API_KEY": "inv_your_key_here" }
    }
  }
}

配置

环境变量	默认值	用途
INVOVATE_API_KEY	—	免费 API 密钥（inv_…）。启用 PDF/UBL 输出和托管链接。
INVOVATE_API_BASE	https://invovate.com	覆盖 API 基地址（通常不需要）。

测试

npm test                                   # lists tools + JSON math (no key)
INVOVATE_API_KEY=inv_xxx npm test          # also exercises the PDF hosted-link path

备注

• 并非受监管的电子发票。 UBL 导出仅用于互操作性/存档。 不符合 Peppol / Factur-X / ZUGFeRD / XRechnung / NF-e 标准，也不提供网络交付。
• 托管链接会过期，发票将在 7 天后删除。
• 面向 Agent 的文档：https://invovate.com/invoice-api-for-ai-agents · OpenAPI：https://invovate.com/openapi.json

提示词示例

连接后，用自然语言向 AI 客户端提问：

Create an invoice for Acme Ltd for 3 hours of consulting at $120/hour. Return it as a PDF.
Generate a UBL 2.1 invoice for a SaaS subscription charged €49/month.
Make a Japanese invoice (¥) for ¥350,000 of web design with 10% consumption tax, and give me the link.

链接

• 发票 API 和文档： https://invovate.com/api · https://invovate.com/invoice-api-for-ai-agents
• OpenAPI 3.1 规范： https://invovate.com/openapi.json（导入为 ChatGPT / Claude Action）
• MCP 介绍页： https://invovate.com/mcp-invoice-generator · 所有集成： https://invovate.com/integrations
• npm（此软件包）： https://www.npmjs.com/package/invovate-mcp-server
• Python SDK： https://pypi.org/project/invovate/ · JavaScript SDK： https://www.npmjs.com/package/invovate
• Glama MCP 目录： https://glama.ai/mcp/servers/LightSpeedPlusOne/invovate-mcp-server
• Postman 集合： https://www.postman.com/lightspeedplusone-9440989/workspace/invovate-invoice-api/overview
• RapidAPI： https://rapidapi.com/LightSpeedPlusOne/api/invovate-invoice
• WordPress 插件： https://wordpress.org/plugins/invovate-invoice-generator/

许可证

MIT © Invovate