MCP 集成

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

1获取 API 密钥

MCP 访问需要与 REST API 相同的 Pro API 密钥。提供 14 天试用。

2配置您的客户端

将此内容放入您的 MCP 客户端设置文件。npx 命令会在首次运行时下载 @kubova/mcp 包。

Claude Code · Claude Desktop · Cursor · Cline:

{
  "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

3与之对话

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

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

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

公开的工具

工具	用途
pack_containers	将 SKU 列表打包到一个或多个集装箱。返回每个集装箱的放置 (x,y,z) 和利用率。
verify_key	API 密钥的健康检查 — 返回身份、范围和速率限制。

源代码

MCP 服务器源代码位于 Kubova monorepo 中的 services/mcp-server.