convez.ai
MCP Server
Kubova-com

kubova-mcp

Kubova-com/kubova-mcp

Ver no GitHub
InicialPluginScore · de 0 a 100

Model Context Protocol (MCP) server for Kubova — pack cargo into shipping containers and onto pallets in 3D, from any AI agent (Claude, Cursor, ChatGPT). Calls the public Kubova API

Instalação

$npx convez-ai Kubova-com/kubova-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

@kubova/mcp

Model Context Protocol server for the Kubova container loading calculator.

Lets Claude, Cursor, Cline, ChatGPT, n8n, and any other MCP-aware AI agent pack shipping containers as a tool call.

Install

# Get an API key first at
#   https://kubova.com/dashboard/api-keys
# (Pro plan; 14-day trial available.)

Configure

Claude Code / Claude Desktop

Add to ~/.claude/settings.json (or the Claude Desktop config file):

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

Cursor / Cline / Codex

Same JSON shape — point your MCP-aware client at the package via npx.

Tools exposed

ToolPurpose
pack_containersPack a list of cargo SKUs into one or more shipping containers. Returns placements, utilization, weight, and any unplaced pieces.
verify_keySanity-check the configured API key. Returns identity, scopes, and rate limit.

Input schema (pack_containers)

{
  cargos: [
    {
      id: string,
      name: string,
      shape?: "box" | "cylinder",
      lengthCm: number,
      widthCm: number,
      heightCm: number,
      quantity: number,
      weightKg: number,
      color?: string,
      includeInLoading?: boolean,
      allowStacking?: boolean,
      allowRotation?: boolean
    }
  ],
  container?: {
    id: string,
    name: string,
    innerLengthCm: number,
    innerWidthCm: number,
    innerHeightCm: number,
    doorWidthCm: number,
    doorHeightCm: number,
    maxPayloadKg: number
  },
  containers?: [ /* multiple types — Kubova picks the best mix */ ],
  options?: {
    loadingDirection?: "floor-to-top" | "right-to-left",
    maxContainers?: number
  }
}

Env

VariableDefaultNotes
KUBOVA_API_KEY—Required. Generated from the dashboard.

License

MIT.

Ver o original no GitHub

Bom para

Relacionados