goods-receipt

mcp-goods-receipt

已收录于 官方 MCP Registry（io.github.theluckystrike/goods-receipt）。

采购订单，以及用于接收订单货物的收货单。采购订单包含参考编号、供应商和带日期的明细行——SKU、描述、订购的整件数量——以及用于判定收货是否需要标记的整数百分比超收/短收容差。针对未关闭的采购订单创建 GRN，每行对应一个单元格：收货数量、损坏数量，以及你已知的任何短缺数量。短缺不是手动填写，而是根据订购数量减去收货数量计算得出，最低为零；只要数字不一致，就会显示为差异。

决定其他一切的唯一规则

超收容差按该明细行在所有 GRN 中累计的总量检查，而不是单独检查每次交付。

对于订购数量为 100、容差为 10% 的订单，可以分三次收货，每次收货 40 件；但第三次会被拒绝，因为累计收货 120 件超过了订购的 100 件，即使单次交付都没有超量。分批交付没有问题——同一采购订单对应多个 GRN 是常见情况——而累计规则可以防止无声超收。

由此还引出两条较小的规则：

• 不存储任何派生数据。 每次调用时，都会根据采购订单明细行和已记录的 GRN 计算短缺和差异。只有损坏数量需要手动填写，因为这是仓库实际能看到的唯一情况。
• 超出容差的收货会被拒绝，而不会截断。 除非额外的货物申报为损坏，否则超出超收容差的收货不会写入任何内容，并会说明原因。损坏数量仍计入容差检查——“货物到达时已经损坏”并不意味着可以订购 100 件却收货 130 件。

工具

工具	功能
po_add	创建采购订单：参考编号、供应商、带日期的明细行、超收/短收容差
grn_add	接收未关闭采购订单的货物：逐行填写收货/损坏数量，短缺自动计算
grn_line_add	向未关闭的 GRN 添加一条明细行
grn_list	按时间从新到旧列出 GRN，可按采购订单或状态筛选
grn_get	获取单个 GRN：显示每条明细行的收货数量、损坏数量、短缺和备注
grn_discrepancy	列出短缺、超收、损坏或已关闭但仍有未结数量的明细行
grn_close	数量核对完成后关闭 GRN
grn_status_report	列出所有采购订单：未关闭明细行、累计收货数量和剩余待收数量
grn_export_csv	将 GRN 导出为 CSV（Pro）
license_status	查看此安装使用的套餐等级及密钥来源
license_activate	为此服务保存 Pro 密钥

快速开始

po_add  { "reference": "ACME-1001", "supplier": "Acme Trading",
          "lines": [ { "sku": "BRK-8", "description": "Bracket, steel", "ordered": 100 } ] }
grn_add { "po": "PO-0001",
          "lines": [ { "line": "L01", "received": 60 } ] }
grn_add { "po": "PO-0001",
          "lines": [ { "line": "L01", "received": 35, "damaged": 2 },
                     { "line": "L01", "received": 10 } ] }   // refused: 105 > 100 + 10%
grn_discrepancy {}                                        // L01 is 5 short of 100

ID 格式如 PO-0001 和 GRN-0001；采购订单中的明细行格式为 L01、L02，依此类推。

快速开始

{ "tool": "po_add", "args": { "reference": "ACME-1005", "supplier": "Acme Trading",
            "lines": [{ "sku": "BRK-01", "description": "Bracket, steel", "ordered": 10 }] } }
{ "tool": "grn_add", "args": { "po": "PO-0001", "lines": [{ "line": "L01", "received": 9, "damaged": 1 }] } }
{ "tool": "grn_discrepancy", "args": { "po": "PO-0001" } }

如果 GRN 收货数量超过超收容差，则会被拒绝；短缺按订购数量减去收货数量计算，并显示为差异。grn_export_csv（Pro）可将完整台账导出为 CSV。

Free 与 Pro

	Free	Pro
采购订单	最多 2,000 个	最多 2,000 个
GRN	最多 5,000 个	最多 5,000 个
每个采购订单 / GRN 的明细行数	最多 200 条	最多 200 条
grn_list、grn_get、grn_discrepancy、grn_status_report	是	是
grn_export_csv	否	是

所有套餐的业务数据均设有统一上限（2,000 个采购订单、5,000 个 GRN、200 条明细行）——这些是硬性限制，目的是防止数据规模超过文件格式的承载能力，并非付费墙。Pro 可解锁 CSV 导出，便于将收货记录导入电子表格或 ERP。

获取 Pro：https://mcp.zovo.one/buy/goods-receipt（一次性付费），或以一个价格使用所有服务：https://mcp.zovo.one/buy/bundle

隐私

所有数据都保留在本地，存储于 ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/goods-receipt/ 中，分别保存在 store.json（PO 和 GRN）和 counter.json（PO 和 GRN 序列）里。此服务不会进行任何网络调用，无需 API 密钥，也无需账户。它读取的唯一一个非自有文件是共享业务资料，并且绝不会写入该文件。

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

将这些文档用作 MCP 服务

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

• 文档 MCP URL：https://gitmcp.io/theluckystrike/mcp-goods-receipt