BillingEngine

BillingEngine MCP 服务

通过与 Claude、Cursor 或任何其他 MCP 客户端对话，在 BillingEngine 中创建客户和发票、查找未结发票并记录付款：

“为 Acme Painting 创建一张金额超过 100 欧元的发票。”

“哪些发票已逾期？”

“Acme 已支付发票 2610030028，记录这笔付款。”

BillingEngine 是面向自由职业者和小型企业的开票软件，支持 电子发票（EN 16931、XRechnung、ZUGFeRD / Factur-X）。 该服务是 BillingEngine API 的轻量封装， 并在你的计算机上运行。

要求

• Node.js 20 或更高版本
• 付费套餐的 BillingEngine 账户。免费套餐不提供 API。
• BillingEngine 中 设置 > API 密钥 页面里的 API 密钥

设置

Claude Desktop

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "billingengine": {
      "command": "npx",
      "args": ["-y", "billingengine-mcp"],
      "env": { "BILLINGENGINE_API_KEY": "your-api-key" }
    }
  }
}

Claude Code

claude mcp add billingengine --env BILLINGENGINE_API_KEY=your-api-key -- npx -y billingengine-mcp

Cursor 和其他客户端

在客户端的 MCP 设置中使用上文相同的 command、args 和 env。

工具

工具	功能
find_customers	按公司、姓名、电子邮件或其他系统的标识符搜索客户
create_customer	创建客户
update_customer	修改客户
create_invoice	为客户创建草稿发票
update_invoice	修改草稿发票
list_invoices	按状态、类型、客户、编号、标识符或日期筛选并列出发票
get_invoice	返回一张发票及其项目、税额明细和状态
download_invoice	将 PDF 或 XML 电子发票保存到你的下载文件夹
record_payment	记录已发送发票的付款
list_payments	列出付款，可选仅列出一张发票的付款

功能与限制

• 创建的发票均为草稿。不会向客户发送任何内容；你需要在 BillingEngine 中审核并发送发票。每项结果都包含一个用于打开草稿的链接。
• 价格采用含税或未税方式，取决于你的账户设置；每张发票都会注明所用方式。结果中的金额为 "119.00" 这样的十进制字符串。编号、语言、文本、增值税处理方式和付款期限均来自你的账户设置，与发票表单中的设置完全一致。
• 通过此服务无法删除任何内容。
• 新发票会计入套餐的月度发票数量上限。
• 每个密钥每分钟最多可发送 60 个 API 请求。
• 你的密钥保留在计算机上，且仅发送给 BillingEngine。

如果密钥泄露，请在 设置 > API 密钥 中创建一个新密钥。旧密钥会立即失效。设置页面还会显示该密钥的上次使用时间。

配置

变量	含义
BILLINGENGINE_API_KEY	你的 API 密钥（必填）
BILLINGENGINE_URL	基础 URL，默认为 https://www.billingengine.com

开发

npm install
npm run build
BILLINGENGINE_API_KEY=... node dist/index.js

许可证

MIT。BillingEngine 本身是一项商业服务；请参阅 billingengine.com。