MCP 集成

将 Kubova 接入 Claude、Cursor、Cline、ChatGPT 或任何支持 MCP 的 AI 代理。通过一次工具调用打包集装箱。

1通过 URL 连接（无需安装）

只需一个 URL 即可将 Kubova 添加为远程连接器。AI 客户端会打开安全登录到您的 Kubova 账户——无需 API 密钥，无需终端。

https://kubova.com/mcp

Claude (claude.ai / Desktop): 设置 → 连接器 → 添加自定义连接器 → 粘贴 URL。
ChatGPT: 设置 → 应用与连接器 → 启用开发者模式 → 创建 → 粘贴 URL。
Cursor · VS Code: 将 URL 添加为远程 MCP 服务器；按提示登录。

工具调用按您的套餐和配额运行。装箱和报告需要 Pro 或 Team（提供 14 天试用）。

2与之对话

重启您的客户端，然后向 AI 询问任何需要集装箱打包的事情：

> Pack 20 boxes of 50x40x30 cm into a 40HC container.
> What's the utilization?

代理将调用 pack_containers 工具，渲染放置，并解释结果。

备选：本地安装（npm）

偏好本地 stdio 服务器（离线配置文件、CI、n8n）？使用带 API 密钥的 npm 包。

获取 API 密钥 →

{
  "mcpServers": {
    "kubova": {
      "command": "npx",
      "args": ["-y", "@kubova/mcp@latest"],
      "env": {
        "KUBOVA_API_KEY": "kbv_..."
      }
    }
  }
}

Claude Code: ~/.claude/settings.json · Claude Desktop: claude_desktop_config.json · Cursor: ~/.cursor/mcp.json

公开的工具

工具	用途
pack_containers	将 SKU 列表打包到一个或多个集装箱。返回每个集装箱的放置 (x,y,z) 和利用率。
generate_report	从之前的pack结果生成PDF报告。返回下载URL。
estimate_capacity	一个集装箱能装下多少完整的产品套组（每套 1+ 种纸箱）——真实 3D 装载，并给出每个集装箱的限制因素。
verify_key	API 密钥的健康检查 — 返回身份、范围和速率限制。

源代码

MCP 服务器在 GitHub 上开源： Kubova-com/kubova-mcp.