billing-docs

mcp-billing-docs

贷项通知单和采购订单，采用与发票相同的引擎。

当客户退回工作，或你向他们重复开具了账单时，你需要给他们开具贷项通知单：这份文件会注明被冲销的发票，并从中扣除相应金额，同时按你收取的税率冲销 VAT。向供应商下单时，你需要给他们开具采购订单：注明你要什么、价格、交付期限，以及你的详细信息。此服务会基于 mcp-invoice 服务已有的发票和客户数据生成这两类文件，并且不会让贷项通知单退还超过发票收取的金额。若重复发送同一份文件，系统会通过已存在文件的 ID 拒绝；如果某份文件没有任何内容依赖它，则可以删除，因此重新发送不会占用免费套餐的名额。所有数据都保留在你的设备上。

基于 @theluckystrike/mcp-invoice/lib 构建：金额、VAT、货币和格式化代码均来自发票服务，而非另行复制，因此贷项通知单与其冲销的发票在最小货币单位上保持一致。

已收录于官方 MCP Registry（io.github.theluckystrike/billing-docs-credit-notes-purchase-orders）。

@theluckystrike/mcp-billing-docs 的 npm 发布尚待完成，因此目前运行 npx -y @theluckystrike/mcp-billing-docs 会返回 404。在此之前，可通过 .mcpb 一键安装包或克隆并构建来使用。

安装

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "billing-docs": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-billing-docs"]
    }
  }
}

Claude Code：

claude mcp add billing-docs -- npx -y @theluckystrike/mcp-billing-docs

Cursor（.cursor/mcp.json）：

{
  "mcpServers": {
    "billing-docs": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-billing-docs"]
    }
  }
}

同时运行 mcp-invoice：此服务会读取该服务中的发票和客户数据，两个服务都会从同一份企业资料中获取名称、地址、VAT ID 和默认货币。

工具

工具	功能
credit_note_create	为发票开具贷项通知单：可冲销整张发票、指定总额，或指定数量的具名项目
credit_note_list	列出所有贷项通知单，并按货币显示已冲销总额。可按发票、客户或日期筛选
credit_note_get	查看一份贷项通知单的完整内容
credit_note_pdf	生成 A4 PDF，标题为 CREDIT NOTE，并注明其冲销的发票编号（Pro）
credit_note_text	获取纯文本版本，可粘贴到电子邮件中
credit_note_delete	删除尚未关联到发票或生成文件的贷项通知单：恢复每月免费名额
purchase_order_create	创建采购订单：项目、VAT、货币和预计交付日期
purchase_order_list	列出所有订单及其状态：未结、部分收货、已收货
purchase_order_get	查看一份订单的完整内容及其收货记录
purchase_order_pdf	生成 A4 PDF，标题为 PURCHASE ORDER（Pro）
purchase_order_text	获取可发送给供应商的纯文本版本
purchase_order_receive	标记订单已收货，可标记全部或部分收货
purchase_order_delete	删除尚未收货且未生成文件的订单：恢复每月免费名额
billing_docs_report	按货币统计已冲销金额、订单金额，以及超过交付日期的订单（Pro）
license_status、license_activate	查看免费版或 Pro 状态，以及如何升级

一个资源 billing-docs://open-orders，以及一个提示词 chase_deliveries。

Free 版与 Pro 版

	Free	Pro
每个日历月的文档数量	5 份，贷项通知单和采购订单合计	无限
credit_note_delete, purchase_order_delete	是：上限按存储中的文档数量计算，因此删除后会释放名额	是
credit_note_text, purchase_order_text	是，无限制	是
全额、部分及逐项贷项通知单、VAT、多币种、收货订单	是	是
credit_note_pdf, purchase_order_pdf	否	是，另可添加您的徽标，且页脚不显示署名
billing_docs_report	否	是

获取 Pro 版：https://mcp.zovo.one/buy/billing-docs（此服务一次性收费 $19，套装售价 $39）。

一个经过核算的例子

按单一税率为混合 VAT 发票的一部分开具贷项通知单，结果会产生远超预期的舍入误差。 一张发票包含 EUR 1,000.00 的咨询服务（税率为 23%）和 EUR 500.00 的印刷品（税率为 8%），总额为 EUR 1,770.00。按单一税率贷项通知单的方式，冲销其中的百分之十，即 EUR 177.00：未税金额为 EUR 143.90，VAT 为 EUR 33.10。此服务会按发票实际使用的各税率所占比例，将冲销金额分摊到各税率，得出未税金额 EUR 150.00；其中 23% 税率对应的 VAT 为 EUR 23.00，8% 税率对应 EUR 4.00，VAT 合计 EUR 27.00。无论采用哪种方式，客户看到的含税总额都相同。VAT 项相差 EUR 6.10，占其金额的 22.6%，而这个数字将用于 VAT 申报表。

test/unit.test.mjs 中的断言：“按金额开具贷项通知单时，会按发票的 VAT 税率分摊含税总额，并沿用每种税率”。

隐私

所有数据都保存在本地：${XDG_DATA_HOME:-~/.local/share}/mcp-servers/billing-docs/。无需账户、API 密钥，也绝不会发起网络请求。许可证密钥会离线验证。

由 theluckystrike 构建。支持邮箱：[email protected]

将这些文档用作 MCP 服务

任何 MCP 客户端（Claude、Cursor、Windsurf、VS Code）都可以通过 GitMCP 直接读取此代码库的文档，无需安装：

• Docs MCP URL：https://gitmcp.io/theluckystrike/mcp-billing-docs