goods-receipt

mcp-goods-receipt

公式 MCP Registry に登録されています（io.github.theluckystrike/goods-receipt）。

発注書と、発注品を受領するための入荷伝票を管理します。発注書には参照番号、仕入先、日付付きの明細（SKU、説明、発注した整数単位）があり、入荷を要確認としてフラグ付けするかどうかを決める、整数パーセントの過不足許容率も設定します。未完了の発注書に対して入荷伝票を作成し、明細ごとに受領数、破損数、既知の不足数を記録します。不足数は入力するのではなく、発注数から受領数を引き、ゼロを下限として算出します。数値が一致しないと、すぐに差異として表示されます。

それ以外のすべてを決める唯一のルール

過剰許容率の判定は、個々の納品ごとではなく、その明細に対して作成されたすべての入荷伝票の累計数に基づいて行われます。

許容率が10％で発注数が100の場合、40ずつの納品を3回に分けて受け入れることはできません。1回目と2回目は受け入れられますが、3回目は拒否されます。単一の納品では超過していなくても、発注数100に対して受領数が120となり、過剰許容率を超えるためです。分納は問題ありません。同じ発注書に対して複数の入荷伝票を作成するのが通常のケースです。累計ルールにより、気づかないうちに受領数が発注数を超えるのを防ぎます。

ここから、2つの小さなルールが導かれます。

• 算出値は保存しません。 不足数と差異は、発注書の明細と記録済みの入荷伝票から、呼び出しのたびに算出されます。入力するのは破損数のみです。倉庫で実際に確認できるのは破損数だけだからです。
• 許容率を超える受領は拒否され、上限に丸められることはありません。 余分な数量が破損として申告されていない限り、過剰許容率を超える入荷は何も記録せず、その理由を示します。破損した数量も許容率の判定には含まれます。「破損して届いた」からといって、100個を発注して130個受け取ってよいわけではありません。

ツール

ツール	機能
po_add	発注書を作成します。参照番号、仕入先、日付付きの明細、過不足許容率を指定します
grn_add	未完了の発注書に対して入荷を記録します。明細ごとの受領数と破損数を指定し、不足数は自動算出されます
grn_line_add	未完了の入荷伝票に明細を1件追加します
grn_list	入荷伝票を新しい順に表示し、発注書またはステータスで絞り込みます
grn_get	1件の入荷伝票について、受領数、破損数、不足数、備考を含むすべての明細を表示します
grn_discrepancy	不足、超過、破損がある明細や、残数量がある状態でクローズされた明細を表示します
grn_close	数量が確定した入荷伝票をクローズします
grn_status_report	すべての発注書について、未完了の明細、累計受領数、未受領数を表示します
grn_export_csv	入荷伝票を 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_export_csv（Pro）は、台帳全体を CSV として出力します。

Free と Pro

	Free	Pro
発注書	最大2,000件	最大2,000件
入荷伝票	最大5,000件	最大5,000件
発注書／入荷伝票あたりの明細	最大200件	最大200件
grn_list、grn_get、grn_discrepancy、grn_status_report	利用可能	利用可能
grn_export_csv	利用不可	利用可能

ドメイン全体の上限は、すべてのプランで同じです（発注書2,000件、入荷伝票5,000件、明細200件）。これはファイル形式で扱える範囲を超えてストアが増大しないようにするための厳格な制限であり、課金のための制限ではありません。Pro では、入荷記録をスプレッドシートや ERP に取り込むための CSV エクスポートが利用できます。

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