packing-list

mcp-packing-list

公式 MCP Registryに登録されています（io.github.theluckystrike/packing-list）。 出荷品の梱包明細書であり、梱包中に誰もが尋ねるたった2つの質問、つまり「どの箱に何が入っているか」と「何がまだ梱包されていないか」への答えです。指定した注文に対して梱包明細書を作成し、その注文で出荷すべき明細を記載します。風袋重量と外寸を指定してカートンを追加し、1回の呼び出しにつき1つずつ商品をカートンに入れます。packing_shortfall は各明細について、不足、完了、過剰梱包、または注文にない商品の梱包済みのいずれかを報告します。carton_report はカートンごと、および出荷全体の風袋重量、正味重量、総重量、容積、容積重量、課金対象重量を示します。

これは簡略化ではなく、この書類の本来の役割です。書類は箱の中に入れられ、荷受人の倉庫は商品の価格を知る立場にありません。同じ注文に対するインボイスは別の書類であり、@theluckystrike/mcp-invoice にあります。このサーバーでは金額計算を一切行わず、それを検証するテストもあります。

重量はすべて整数のグラム単位、寸法は整数のセンチメートル単位です。これは金額を最小通貨単位で扱うのと同じ理由によります。キログラムを浮動小数点数で扱うと、100行を超えるうちに誤差が蓄積し、運送業者の秤の値と一致しなくなるためです。

算出値は保存しません。レコードにはカートン、申告済みの注文明細、梱包済みの明細を保持し、重量と不足分全体は呼び出し時に計算します。総重量を保存すると、明細にすでに記載されている情報のコピーができてしまい、誰かが明細を取り出した後もそのコピーが信頼されてしまいます。

課金対象重量、つまり料金を決める数値

宅配便業者は、箱の実重量と容積に基づく重量のうち、大きい方を請求します。容積重量はセンチメートル単位で length x width x height / divisor として計算します。除数は運賃条件によって異なります。5000 cm3/kg は航空貨物の一般的な値、6000 は以前の IATA の航空貨物基準値、4000 は一部の陸上輸送運賃で使われます。除数は容積重量を報告するすべてのツールでパラメーターとして指定し、数式内の定数にはしません。誤った除数で算出した課金対象重量は、勘定を照合するまで誰も気づかない運送業者からの請求につながるためです。

ここで重要な拒否動作は2つあり、どちらも意図的なものです。

• 3辺のうち2辺しか指定されていないカートンは、そのまま拒否されます。3辺のうち2辺だけでは容積を計算できず、一部しか測定されていない箱が出荷合計から気づかれないまま除外されるためです。
• いずれかのカートンに寸法がまったく指定されていない場合、出荷全体の容積重量と課金対象重量の合計は null になります。3箱を黙って除外した合計にはなりません。

インストール

ワンクリックインストール（.mcpb）：最新リリースから packing-list.mcpb をダウンロードし、Claude Desktop でダブルクリックします：https://github.com/theluckystrike/mcp-servers/releases/latest

@theluckystrike/mcp-packing-list の npm 公開は保留中のため、以下の npx コマンドは現時点では 404 を返します。それまではソースからビルドしてください。llms-install.md を参照してください。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "packing-list": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-packing-list"]
    }
  }
}

Claude Code

claude mcp add packing-list -- npx -y @theluckystrike/mcp-packing-list

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト）に、Claude Desktop と同じエントリーを記述します。

ツール

ツール	機能
packing_list_create	注文に対する梱包明細を作成します。参照番号、荷受人、配送先、日付を指定します
packing_expect	注文の明細行を登録し、不足分を正確に把握できるようにします。見積書、作業指示書、請求書のストアから情報を読み取ることはありません
carton_add	梱包箱を追加します。ラベル、グラム単位の空箱重量、および外寸3辺すべて（または寸法なし）を指定します
pack_item	数量と1個あたりの重量（グラム単位）を指定して、指定した梱包箱に1種類の品目を入れます
unpack_item	L01形式のIDを指定して、梱包済みの明細行を取り出します。削除され、数量がゼロになるわけではありません
packing_list_show	リスト全体を表示します。内容と重量を含む梱包箱、注文済みの明細行、不足分、出荷準備ができているかどうかを確認できます
packing_list_list	梱包明細を新しい順に表示し、ステータス、注文参照番号、または荷受人で絞り込みます
carton_report	梱包箱ごと、および出荷全体の風袋重量、正味重量、総重量、容積、容積重量、課金重量を表示します
packing_shortfall	注文数量と梱包数量を照合し、不足分、過剰梱包分、注文にない品目を確認します
packing_list_status	draft から packed、shipped へ、または cancelled に変更します。出荷時には運送業者と追跡情報を記録し、リストを固定します
packing_slip	すべてのプランでテキスト形式の梱包明細を作成します。Pro では out_path に .txt ファイルとして書き込みます
packing_list_delete	リストを完全に削除します。出荷済みのリストは拒否されます。建物から出た荷物の記録だからです
license_status	このインストールのプランと、キーの取得元を確認します
license_activate	このサーバーに Pro キーを保存します

また、ステータスの遷移、重量の基準、不足状態ごとの意味、無料プランの上限、このサーバーが書き込む唯一のディレクトリを記載した packinglist://contract リソースと、作業全体を順番に案内する pack_the_shipment プロンプトもあります。

無料プランと Pro

	無料プラン	Pro
同時に開ける梱包明細	3	無制限
梱包箱、梱包済み明細行、注文済み明細行	無制限	無制限
carton_report、packing_shortfall、packing_list_show	利用可能	利用可能
テキスト形式の梱包明細	利用可能	利用可能
out_path を使った梱包明細のファイルへの書き込み	利用不可	利用可能

上限は進行中の出荷件数に対するものであり、箱の中身を把握する機能に対するものではありません。リストを出荷済みまたはキャンセル済みにすると枠が空きます。下書きを削除した場合も同様です。そのため、無料プランのユーザーはキーがなくても、いつでも上限内に戻せます。

Pro の購入先：https://mcp.zovo.one/buy/packing-list （買い切り）、またはすべてのサーバーを一括購入（価格は1つ）：https://mcp.zovo.one/buy/bundle

プライバシー

すべてのデータは ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/packing-list/ 内にローカル保存されます。このサーバーがネットワーク通信を行うことはなく、API キーもアカウントも必要ありません。このサーバーが所有していないファイルで読み取るのは、梱包明細の上部に記載する名前と住所を取得するための共有ビジネスプロフィールのみであり、そこに書き込むことはありません。

theluckystrike が開発しました。サポート：[email protected]

これらのドキュメントを MCP サーバーとして利用する

GitMCP を使えば、どの MCP クライアント（Claude、Cursor、Windsurf、VS Code）でも、このリポジトリのドキュメントをインストール不要で直接読み取れます。

• ドキュメント MCP URL：https://gitmcp.io/theluckystrike/mcp-packing-list