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 分