McpStamp Goods Receipt

io.github.theluckystrike由 GitHub 账号 theluckystrike 发布v0.23.0更新于 Nov 3, 2026

按采购订单收货:支持部分收货、损坏或短缺数量,并显示每个订单的状态。

AI 翻译由 AI 模型根据下方的原文描述翻译,可能有误。

原文描述

Receive goods against purchase orders: partial, damaged or short units, and each order's status.

已验证Streamable HTTP可网页运行效率与工作流数据与分析商业与电商

概览

McpStamp Goods Receipt 的托管 MCP 服务(mcp.zovo.one);无需登录;Streamable HTTP;11 个工具。

暂无 AI 概览:以下信息来自注册中心条目和服务本身。

端点
mcp.zovo.one
最近检查

安装

在 SourceWeft 中

  1. 打开 控制台中的 McpStamp Goods Receipt,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.theluckystrike%2Fgoods-receipt/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "mcpstamp-goods-receipt": {
      "type": "http",
      "url": "https://mcp.zovo.one/mcp/goods-receipt"
    }
  }
}

README

mcp-goods-receipt

[theluckystrike/mcp-goods-receipt MCP server]

In the official MCP Registry (io.github.theluckystrike/goods-receipt).

Purchase orders and the goods-receipt notes that receive them. A PO carries a reference, a supplier, and dated lines - sku, description, whole units ordered - plus whole-percent over/under tolerances that decide when a receipt is flagged. A GRN is raised against an open PO, one cell per line: units received, units damaged, and any shortage you already know about. Shortage is derived, not typed - ordered minus received, floored at zero - and shows up as a discrepancy the moment the numbers disagree.

The one rule that decides everything else

Over-tolerance is checked against the cumulative total across every GRN raised on the line, not against each delivery in isolation.

Three deliveries of 40 against an order of 100 at 10% are allowed in ones and tens but the third delivery is refused, because 120 received of 100 ordered breaks the over tolerance even though no single delivery did. Partial deliveries are fine - several GRNs against the same PO is the normal case - and the cumulative rule is what stops them quietly over-receiving.

Two smaller rules follow from it:

  • Nothing derived is stored. Shortage and discrepancy are worked out on every call from the PO lines and the GRNs already recorded. Damage is the only thing typed in, because it is the only thing the warehouse actually sees.
  • Receiving past tolerance is refused, never clamped. Unless the extra units are declared damaged, a receipt that breaks the over tolerance writes nothing and says why. Damaged units still count for the tolerance check - "it arrived broken" is not a licence to order 100 and receive 130.

The tools

ToolWhat it does
po_addCreate a purchase order: reference, supplier, dated lines, over/under tolerances
grn_addReceive goods against an open PO: received/damaged per line, shortage derived
grn_line_addReceive one more line onto an open GRN
grn_listGRNs newest first, filtered by PO or status
grn_getOne GRN: every line with received, damaged, shortage and notes
grn_discrepancyLines short, over, damaged, or closed with outstanding amounts
grn_closeClose a GRN once the count is settled
grn_status_reportEvery PO: open lines, cumulative received, what is still outstanding
grn_export_csvGRNs as CSV (Pro)
license_statusWhich tier this install is on and where the key came from
license_activateStore a Pro key for this server

Quick start

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

Ids look like PO-0001 and GRN-0001; lines inside a PO are L01, L02, ….

Quick start

{ "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" } }

A GRN that arrives past the over tolerance is refused; shortage is computed as ordered minus received and shown as a discrepancy. grn_export_csv (Pro) writes the whole ledger out as CSV.

Free vs Pro

FreePro
Purchase ordersup to 2,000up to 2,000
GRNsup to 5,000up to 5,000
Lines per PO / per GRNup to 200up to 200
grn_list, grn_get, grn_discrepancy, grn_status_reportyesyes
grn_export_csvnoyes

The domain is capped estate-wide (2,000 POs, 5,000 GRNs, 200 lines) on every tier - these are hard rules so a store cannot grow past what the file format can hold, not a paywall. Pro unlocks CSV export for pushing receipts into a spreadsheet or an ERP.

Get Pro: https://mcp.zovo.one/buy/goods-receipt (one-time), or all servers for one price at https://mcp.zovo.one/buy/bundle

Privacy

All data stays local, in ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/goods-receipt/, in store.json (POs and GRNs) and counter.json (the PO- and GRN- series). There is no network call anywhere in this server, no API key, and no account. The only file it reads that it does not own is the shared business profile, and it never writes to it.

Built by theluckystrike. Support: [email protected]

Use these docs as an MCP server

Any MCP client (Claude, Cursor, Windsurf, VS Code) can read this repository's documentation directly via GitMCP - no install:

来源:servers/goods-receipt/README.md,提交 55b3f42

工具

11

po_add

Add a purchase order

Create a purchase order to receive goods against. Lines carry a sku, a description and an ordered whole-unit quantity. Over/under tolerances are whole percentages allowed above/below ordered before a GRN is flagged. Ids look like PO-0001. Free tier, full CRUD.

输入参数lines必填supplier必填reference必填overTolerancePctunderTolerancePct

grn_add

Receive goods against a purchase order

Create a goods-receipt note (GRN) against an open purchase order. Give one cell per PO line: the whole units received and/or damaged. received is checked against the line's ordered quantity and the PO's over tolerance; receiving past the over tolerance is refused unless declared damaged. Shortage is recorded automatically (ordered minus received, floored at zero) and shown as a discrepancy. Partial deliveries are fine: raise several GRNs against the same PO. Free tier, full CRUD.

输入参数po必填notelines必填carrierreceivedAt

grn_line_add

Add a line to an open GRN

Add another PO line (or more units on a line already open on this GRN) to an existing open goods-receipt note. Useful when one delivery arrives in batches. The over-tolerance gate still applies to the PO line's cumulative received count across every GRN. Free tier, full CRUD.

输入参数grn必填line必填damagedreceived必填damageNoteshortageNote

grn_list

List goods-receipt notes

List goods-receipt notes, newest first, optionally filtered to one purchase order.

输入参数poincludeLines

grn_get

Get one goods-receipt note

Get a single goods-receipt note by id, with its lines, damage and shortage per line.

输入参数grn必填

grn_discrepancy

List discrepancies

List lines that are not as ordered: damaged units, a declared shortage, or received below the PO line's under tolerance. Optionally filter to one PO.

输入参数poincludeResolved

grn_close

Close a goods-receipt note

Close an open GRN. A closed GRN can no longer take lines, and its discrepancies are treated as resolved. Closing is free-tier and never mutates the PO.

输入参数grn必填

grn_status_report

Goods-receipt status report

Reconcile every purchase order against every GRN: open POs (not yet fully received), POs fully received within tolerance, POs with at least one discrepancy, and per-line open/short/damaged counts. Nothing is written.

输入参数includeOnlyDiscrepancies

grn_export_csv

Export goods receipts as CSV

Pro. Export every GRN (or just one PO's GRNs) as CSV with a header row: grn,po,po_reference,received_at,carrier,status,line,sku,received,damaged,shortage,damage_note,shortage_note. Watermark-free and not truncated.

输入参数po

license_status

License status

Report this endpoint's licence state for your token as JSON: the product, the tier free or pro, why it is not Pro, and the checkout URL. Call it to explain a free-tier refusal. No arguments, nothing changes.

无需输入参数。

license_activate

Activate license

Turn Pro on for this connection with key, an MCPL1.<payload>.<signature> issued at checkout for this server or the bundle. Data under your token stays; a wrong or expired key changes nothing. license_status confirms it.

输入参数key必填

版本历史

3
  1. v0.23.0最新Nov 3, 2026
  2. v0.22.6Oct 14, 2026
  3. v0.22.0Sep 20, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分