3DPACK.ING — 3D Bin Packing

3DPACK.ING MCP 服务

面向 AI 助手的集装箱和卡车装载规划。用通俗的语言描述货物，即可获取可装载这些货物的集装箱、每个集装箱的装载率、未能装载的货物，以及交互式 3D 装载方案链接。

由 3DPACK.ING 求解器提供支持，也就是网页版规划工具使用的同一套求解器。有人问“500 个纸箱能装进一个 40 英尺集装箱吗？”没有这个工具的助手只会计算体积，而这种算法会忽略堆叠规则、朝向和重量限制，严重高估实际货物的装载量。

安装

托管版（无需安装）

该服务通过可流式传输的 HTTP 运行在 https://3dpack.ing/mcp。将地址添加到助手中，并在提示时使用你的 3DPACK.ING 账户登录——通过 OAuth 登录，就像 Claude、ChatGPT 和 Claude Code 连接任何服务一样。免费账户即可使用，每月可使用免费额度内的装载方案。

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。

完全不提供凭据的请求会收到 401 响应，并附带登录元数据地址（/.well-known/oauth-protected-resource/mcp），客户端正是通过它显示登录界面的。

本地版（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——一个必需参数 prompt，用通俗的语言描述货物；另外还有两个可选设置：speed 可设为 fast、normal 或 thorough，stability 可设为 75 到 100。

stability 表示箱子底面有多大比例必须由下方物体支撑，以其自身底面积的百分比表示。省略时默认为 75，这是标准规则，允许四分之一的箱子悬空，装载量最大。对于不能倾斜的货物（如桶、玻璃制品及任何顶部较重的物品），请调高此值；如果要求每个堆叠的箱子都必须获得完整支撑，请设为 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 字节；对于大型包装，这可能决定回答是可用还是被信息淹没。

套餐限制不会作为错误报告。对于 NotSubscribed，API 会返回 HTTP 500，与求解器崩溃时使用的状态码相同。如果不加处理，助手会将其理解为“服务出故障了”，并让用户稍后重试；但实际情况是，用户请求了 Pro 功能。本服务会区分这两种情况，并转达相应的套餐提示。

如果响应内容不是 JSON——例如来自代理、VPN 或公司出口白名单的响应——系统会报告网络问题，并指出实际响应方，而不是报告包装失败。只有前一种问题是用户可以解决的。

环境变量

变量	用途
THREEDPACKING_API_KEY	API 密钥。未设置时使用共享演示账户。
THREEDPACKING_USERNAME	此密钥所属的账户。与密钥一同使用时必填。
THREEDPACKING_ENDPOINT	覆盖端点，可用于 staging、可自托管服务或存根。

开发

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

smoke.js 的实时检查刻意不使用模拟。这个软件包可能出问题的原因是 3dpack.ing 更改了响应结构，而模拟无论做得多全面，都无法捕捉到这一点。发布前请运行它。若要在不消耗计算额度的情况下测试成功路径，可将 THREEDPACKING_ENDPOINT 指向存根。

许可证

MIT。