3DPACK.ING — Container & Truck Load Planning

3DPACK.ING MCP server

AI アシスタント向けのコンテナおよびトラックの積載計画です。出荷内容を平易な英語で説明すると、積載できるコンテナ、それぞれの積載率、積載できなかったものと、インタラクティブな3D積載計画へのリンクが返されます。

3DPACK.INGのソルバーを使用しています。これはウェブプランナーと同じものです。「40フィートコンテナに500個のカートンは積めますか」と尋ねられた場合、これがなければアシスタントは体積だけで計算します。すると、実際の貨物で重要な積み重ねのルール、向き、重量制限が考慮されず、積載できる量を大幅に過大評価してしまいます。

インストール

ホスト型（インストール不要）

サーバーはストリーミング可能なHTTP経由で https://3dpack.ing/mcp で稼働しています。このアドレスをアシスタントに追加し、求められたら3DPACK.INGアカウントでサインインしてください。Claude、ChatGPT、Claude Codeがあらゆるサービスに接続するのと同じOAuthを使用します。無料アカウントでも、毎月の無料パックの範囲で利用できます。

Claude（ウェブ、デスクトップ）：設定 → コネクター → カスタムコネクターを追加 → https://3dpack.ing/mcp を貼り付けて、サインインを選択します。

ChatGPT（開発者モード）：同じアドレスをOAuthで追加します。

Claude Code：

claude mcp add --transport http 3dpacking https://3dpack.ing/mcp
# then /mcp → Authenticate

サインインの代わりにAPIキーを使用する場合。 クエリ文字列にキーと、そのキーが属するアカウントを渡します。

https://3dpack.ing/mcp?apiKey=your-key&username=your-username

または、キーをURLに含めずに、URLに ?username=your-username を指定し、X-API-Key: your-key（または Authorization: Bearer your-key、X-3dpacking-Api-Key）を使用します。Claudeのコネクター設定画面では、承認済みのヘッダー名しか送信できないため、ここでは x-api-key を使用してください。共有デモアカウントは ?apiKey=test&username=test です。

認証情報なしのリクエストには、サインイン用メタデータ（/.well-known/oauth-protected-resource/mcp）への案内とともに 401 が返されます。これにより、クライアントにログイン画面が表示されます。

ローカル（npm）

Claude Desktop — claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "3dpacking": {
      "command": "npx",
      "args": ["-y", "@3dpacking/mcp-server"]
    }
  }
}

Claude Code：

claude mcp add 3dpacking -- npx -y @3dpacking/mcp-server

アカウントなしですぐに使用でき、最初の呼び出しは無料プランの共有デモアカウントで実行されます。独自の利用上限で使うには、https://3dpack.ing/login で登録して、次を追加します。

{
  "mcpServers": {
    "3dpacking": {
      "command": "npx",
      "args": ["-y", "@3dpacking/mcp-server"],
      "env": {
        "THREEDPACKING_API_KEY": "your-key",
        "THREEDPACKING_USERNAME": "your-username"
      }
    }
  }
}

両方をセットで設定する必要があります。APIは、ユーザー名のないキーを拒否します。

Claude内の3D計画

MCP Appsに対応するホスト（ウェブ版およびデスクトップ版のClaude）では、回答の下に積載状況が3Dで表示されます。ドラッグして回転、スクロールしてズームできます。荷物の種類ごとに色分けされ、複数のコンテナを使う積載ではページャーが表示されます。ビューは ui://3dpacking/load-plan-<hash>.html です（内容に基づく名前のため、ビューが変わるとホストのキャッシュから古い内容が返されることはありません）。ツールの結果に含まれる配置を _meta から描画するため、配置情報はモデルではなくビューに渡されます。利用には独自のキーが必要です。共有デモアカウントでは、回答とリンクは取得できますが、配置情報は取得できません。他のホストでは、リンク付きの同じ回答がテキストで表示されます。

ツール

pack_shipment — 必須の引数は1つで、貨物について平易な英語で説明する prompt です。任意の設定が2つあり、speed は fast、normal、thorough のいずれか、stability は75〜100です。

stability は、箱をその下の荷物で支える必要がある底面積の割合です。省略した場合は標準ルールの75となり、箱の4分の1がはみ出してもよいため、最大量を積載できます。ドラム缶やガラスなど、傾けてはいけない貨物や重心が高い貨物には値を上げ、積み重ねた箱をすべて完全に支える必要がある場合は100を指定します。これは、何を出荷するかではなくソルバーがどのように積み重ねるかを決める制約であるため、プロンプトでは指定できません。値を上げると積載できる品目数は減ります。

次の内容を理解します。

Pack 50 boxes of 60x40x30 cm into a 20ft container
Load 30 fragile boxes 80x60x40cm, max stack 3, into a 20ft container
Ship mixed pallets: 10x euro pallets, 15x US pallets, best container mix
Ship 24 pcs 200.3x120.2x100.2 cm (non-tiltable), optimal mix of 40ft and 20ft

返される内容：

Everything fits: 1 container.

Container 1 (589.3 x 235 x 239 cm internal)
  items: 50
  of which: 50x Boxes
  used: volume 10.9%
  5 empty gaps left

Interactive 3D load plan: https://3dpack.ing/app?g=6c4b9488-...

形状データの取り扱いについて

API は、各コンテナ内のすべての未充填直方体の座標付き形状データを返します。これは 3D ビューアーに必要なデータで、実際の出荷ではペイロードの大部分を占めます。リンクを開けばまさにその画像を見られるのに、空きスペースの座標にモデルのコンテキストを費やすのは得策ではありません。そのため、要約には空きスペースの「数」だけを残し、形状データは省いています。小さな荷物では 791 バイトから 341 バイトに減り、大きな荷物では回答が実用的なまま収まるか、コンテキストが溢れるかの違いになります。

プランの上限はエラーとして報告されません。API は NotSubscribed に対して HTTP 500 を返します。これはソルバーのクラッシュと同じステータスです。このままでは、アシスタントは「サービスが壊れている」と解釈して、実際にはユーザーが Pro 機能を要求しただけなのに、後でもう一度試すよう伝えてしまいます。このサーバーは両者を判別して、プランの案内を返します。

プロキシ、VPN、企業のアウトバウンド通信許可リストなど、JSON 以外で応答するものについては、梱包の失敗ではなく、実際に応答したものを示したネットワーク問題として報告します。このうち、ユーザー自身で解決できるのは一つだけです。

環境

変数	用途
THREEDPACKING_API_KEY	API キーです。設定されていない場合は共有のデモアカウントを使用します。
THREEDPACKING_USERNAME	キーが属するアカウントです。キーを設定する場合は必須です。
THREEDPACKING_ENDPOINT	エンドポイントを上書きします。ステージング環境、セルフホスト環境、スタブを指定できます。

開発

npm install
npm run smoke     # calls the live solver with demo credentials and checks the shape

smoke.js のライブチェックでは、意図的にモックを使用していません。このパッケージを壊す原因になるのは、3dpack.ing が応答の形式を変更することです。モックをいくら使っても、それは検出できません。公開前に実行してください。計算を消費せずに成功パスを試すには、THREEDPACKING_ENDPOINT をスタブに指定します。

ライセンス

MIT。