bill-of-sale

mcp-bill-of-sale

已收录于 官方 MCP Registry（io.github.theluckystrike/bill-of-sale）。 记录一笔交易，并生成可打印、供签署的销售合同。告诉助手卖方、买方、物品信息，以及适用时的 VIN、序列号或 IMEI、价格和日期，服务就会生成文件：包含交易双方、物品、价格、二手交易的现状出售条款、用你自己的话写的任何保修条款，以及双方的签名栏。你可以先将其作为草稿处理，再定稿为不可更改的签署版本，也可以将其打印为 Markdown，或打印为单个自包含 HTML 文件；该文件可在任何浏览器中打印为 PDF，无需其他资源文件。所有内容都保存在你的设备上；此服务不需要账户，也完全不会发起网络请求。

由 theluckystrike 构建。

@theluckystrike/mcp-bill-of-sale 尚未发布到 npm，因此目前运行 npx -y @theluckystrike/mcp-bill-of-sale 会返回 404。在此之前，可用的方法是克隆并构建。

安装

Claude Desktop

macOS：~/Library/Application Support/Claude/claude_desktop_config.json；Windows：%APPDATA%\Claude\claude_desktop_config.json：

{
  "mcpServers": {
    "bill-of-sale": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-bill-of-sale"]
    }
  }
}

Claude Code

claude mcp add bill-of-sale -- npx -y @theluckystrike/mcp-bill-of-sale

Cursor

~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目），配置项与 Claude Desktop 相同。

工具

工具	功能
sale_create	记录一笔交易并生成销售合同：包含卖方、买方、物品，以及适用时的 VIN/序列号/IMEI、以最小货币单位计的价格和日期。返回 BOS-YYYY-NNNN。除非你确认，否则会拒绝完全相同的重复交易
sale_update	在签署前修改草稿中的任何内容：价格、交易双方、物品详情、标识符、现状出售条款、保修条款、备注。将可选字段设为空字符串即可清除
sale_finalize	将草稿定稿为签署版本。此后 sale_update 会拒绝修改该文件，所有渲染结果也都不会再带有 DRAFT 水印
sale_list	按时间从新到旧列出所有销售合同：编号、状态、日期、物品、买方、卖方、价格。可筛选草稿或已定稿文件
sale_get	根据 BOS 编号获取一份完整的销售合同
sale_delete	直接删除草稿；删除已定稿文件需要设置 confirm_finalized: true。编号不会重新分配，因此序号中的空缺就是删除记录
sale_render	打印文件：输出 Markdown、自包含的 HTML 打印转 PDF 文件，或同时输出两者，并附上签名栏。草稿带有 DRAFT 水印，避免误将审阅版本签署
sale_summary	快速查看账目：草稿和已定稿文件的数量，以及按货币统计的总金额。不同货币的金额不会相加
license_status / license_activate	查询免费版或 Pro 版状态及许可证密钥

免费版与 Pro 版

	免费版	Pro
未关闭的草稿	10	不限
已定稿文件	5	不限
渲染为 Markdown 和 HTML（sale_render）	不限	不限
读取、列出和汇总（sale_get、sale_list、sale_summary）	不限	不限
删除（sale_delete）	可以	可以

文件本身从不计量。你是否持有交易的签署记录，正是此服务要解决的问题；如果免费版不提供文件，那就只是演示版。计量的是保存的记录数量：十份未关闭的草稿和五份已定稿文件，足以应付一整年的副业销售，而不是试用额度。sale_delete 也免费，原因同样在于限制的是保存的记录数量：否则，重复录入的草稿会占用一个名额，除非购买密钥，否则无法释放。

获取 Pro：https://mcp.zovo.one/buy/bill-of-sale，本服务一次性付费 $19，或购买捆绑包，价格为 $39。

销售流程

1. 使用事实信息调用 sale_create。如果共享业务资料中有名称，卖方默认使用该名称，因此整套服务只需填写一次卖方信息。
2. sale_render 会生成带有 DRAFT 水印的审核稿。
3. 使用 sale_update 修正买方或卖方发现的任何问题。
4. 使用 sale_finalize 将其定稿。此后，sale_render 会生成签署稿：在打印件上签字，或将 HTML 打印为 PDF，双方各留一份。

所有金额均为以最小货币单位表示的整数，价格绝不会使用浮点数，日期也会检查是否为真实日历日期。VIN 长度不是 17 个字符，或 IMEI 不是 15 位数字时，系统会按原样存储，但会在响应中标记，因为这两种标识符最容易被买方看错。

隐私

所有数据都保存在本地的 ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/bill-of-sale/ 中。共有两个文件：sales.json、counter.json，以及 documents/ 下生成的文档。数据不会发送到任何地方，没有账户、API 密钥，而且此服务完全不会发起网络请求。许可证密钥会离线验证。

生成的文档是通用模板，不构成法律建议。车辆、船只和受监管商品的销售可能需要遵守销售所在地的法定格式或备案要求。

由 theluckystrike 构建。https://github.com/theluckystrike

将这些文档用作 MCP 服务

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

• 文档 MCP URL：https://gitmcp.io/theluckystrike/mcp-bill-of-sale