Packing List MCP

mcp-packing-list

Servidor MCP para romaneios e listas de embalagem: caixas, conteúdos, pesos, peso cobrável e o que ainda falta embalar. Romaneios sem preços: o que há em cada caixa, quanto pesa e o que ainda falta embalar.

Funciona com Claude Desktop, Claude Code, Cursor e qualquer cliente Model Context Protocol. Roda na sua própria máquina ou hospedado, sem instalação.

Página do produto: https://mcp.zovo.one/s/packing-list — o que faz, as ferramentas que expõe e um endpoint de token ao vivo.

Instalação

Hospedado, nada para instalar. Obtenha um token em https://mcp.zovo.one/mcp/connect (página de conexão) ou https://mcp.zovo.one/mcp/token (o mesmo token em JSON); um token anônimo gratuito é emitido na hora e uma chave Pro funciona da mesma forma. Em seguida, aponte um cliente MCP para https://mcp.zovo.one/mcp/packing-list via streamable-http e envie o token como Authorization: Bearer <token>.

Se o seu cliente não puder definir cabeçalhos, coloque o token no caminho: https://mcp.zovo.one/mcp/packing-list/t/<token>. Ambas as formas funcionam. A URL simples sem token responde 401 em tools/call, portanto o token não é opcional.

Claude Desktop, um clique. Baixe packing-list.mcpb da última versão e clique duas vezes nele.

A partir do código-fonte. O espelho é autocontido: cada dependência @theluckystrike/* é fornecida, então um clone novo compila sem configuração extra.

git clone https://github.com/theluckystrike/mcp-packing-list.git
cd mcp-packing-list
npm install && npm run build

Em seguida, aponte seu cliente para o ponto de entrada compilado:

{
  "mcpServers": {
    "packing-list": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-packing-list/dist/index.js"]
    }
  }
}

@theluckystrike/mcp-packing-list ainda não está publicado no npm, portanto um comando npx -y @theluckystrike/mcp-packing-list falhará. Os três caminhos acima são os que funcionam e cada um é testado pela CI.

Espelho somente leitura de mcp-servers/servers/packing-list. Veja MIRROR.md.

No Registro oficial de MCP (io.github.theluckystrike/packing-list). O romaneio de uma remessa e a resposta às únicas duas perguntas que qualquer pessoa faz ao embalar uma: o que está em qual caixa e o que ainda falta embalar. Uma lista de embalagem é criada contra um pedido que você nomeia, as linhas que esse pedido diz que devem ser enviadas são declaradas nela, caixas são adicionadas com peso de tara e dimensões externas, e as mercadorias vão para as caixas uma chamada por vez. packing_shortfall então reporta cada linha como curta, completa, embalada em excesso ou embalada e não presente no pedido. carton_report fornece o peso de tara, líquido, bruto, volume, peso volumétrico e cobrável por caixa e para a remessa.

Isso não é uma simplificação, é para isso que o documento serve: ele viaja dentro da caixa, e o armazém do consignatário não é a parte que vê quanto custam as mercadorias. A fatura do mesmo pedido é um documento diferente e vive em @theluckystrike/mcp-invoice. Não há nenhuma aritmética de dinheiro neste servidor, e um teste afirma que não há.

A massa é em gramas inteiros em todos os lugares e as dimensões em centímetros inteiros, pela mesma razão que o dinheiro é em unidades menores: um quilograma carregado como float acumula erro ao longo de cem linhas e depois discorda da balança da transportadora.

Nada derivado é armazenado. Um registro contém suas caixas, suas linhas de pedido declaradas e suas linhas embaladas; cada peso e todo o déficit são calculados na chamada. Um peso bruto armazenado é uma segunda cópia do que as linhas já dizem, e é essa cópia que é acreditada depois que alguém desembala uma linha.

O peso cobrável, que é o número que custa dinheiro

As transportadoras cobram o maior entre o que uma caixa pesa e o que seu volume vale. O peso volumétrico é length x width x height / divisor, em centímetros, e o divisor é um termo tarifário: 5000 cm3/kg é o padrão aéreo de courier, 6000 o valor aéreo IATA mais antigo, 4000 aparece em algumas tarifas rodoviárias. É um parâmetro em toda ferramenta que o reporta e nunca uma constante dentro de uma fórmula, porque um peso cobrável calculado com o divisor errado é uma fatura de transportadora que ninguém percebe até a conciliação da conta.

Duas recusas importam aqui e ambas são deliberadas:

• Uma caixa com apenas duas de suas três dimensões é recusada imediatamente. Duas de três não podem formar um volume, e uma caixa parcialmente medida cairia silenciosamente do total da remessa.
• Se qualquer caixa não tiver dimensões, os totais volumétricos e cobráveis da remessa retornam como null, nunca como um total que silenciosamente pulou três caixas.

Instalação

Um clique (.mcpb): baixe packing-list.mcpb da última versão e clique duas vezes nele no Claude Desktop: https://github.com/theluckystrike/mcp-servers/releases/latest

A publicação no npm para @theluckystrike/mcp-packing-list está pendente, então a linha npx abaixo retorna 404 hoje. Compile a partir do código-fonte enquanto isso; veja llms-install.md.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "packing-list": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-packing-list"]
    }
  }
}

Claude Code

claude mcp add packing-list -- npx -y @theluckystrike/mcp-packing-list

Cursor

~/.cursor/mcp.json (global) ou .cursor/mcp.json (projeto), mesma entrada do Claude Desktop.

Ferramentas

Ferramenta	O que faz
packing_list_create	Abrir uma lista de embalagem contra um pedido: a referência, o consignatário, o destino do envio, a data
packing_expect	Declarar uma linha de pedido, para que o déficit seja real. Nada é lido do armazenamento de cotações, ordens de serviço ou faturas
carton_add	Adicionar uma caixa: um rótulo, o peso vazio em gramas inteiros e todas as três dimensões externas ou nenhuma
pack_item	Colocar uma quantidade de um item em uma caixa nomeada, com o peso por unidade em gramas inteiros
unpack_item	Retirar uma linha embalada pelo seu id no estilo L01. Excluída, não zerada
packing_list_show	A lista inteira: caixas com conteúdos e pesos, as linhas de pedido, o déficit e se está pronta para envio
packing_list_list	Listas de embalagem das mais recentes para as mais antigas, filtradas por status, referência de pedido ou consignatário
carton_report	Tara, líquido, bruto, volume, peso volumétrico e cobrável, por caixa e para a remessa
packing_shortfall	Pedido contra embalado: o que está curto, o que está embalado em excesso, o que não está no pedido
packing_list_status	de rascunho para embalado para enviado, ou cancelado. O envio registra a transportadora e o rastreamento, e congela a lista
packing_slip	O romaneio como texto em todos os níveis. Pro também o grava em out_path como arquivo .txt
packing_list_delete	Excluir uma lista permanentemente. Uma lista enviada é recusada: é o registro do que saiu do prédio
license_status	Em qual nível esta instalação está e de onde veio a chave
license_activate	Armazenar uma chave Pro para este servidor

Há também um recurso, packinglist://contract, que carrega a máquina de estados, a base de peso, o que cada estado de déficit significa, os limites do nível gratuito e o único diretório que este servidor grava; e um prompt, pack_the_shipment, que percorre todo o trabalho em ordem.

Gratuito vs Pro

	Gratuito	Pro
Listas de embalagem abertas ao mesmo tempo	3	ilimitado
Caixas, linhas embaladas, linhas de pedido	ilimitado	ilimitado
carton_report, packing_shortfall, packing_list_show	sim	sim
O romaneio como texto	sim	sim
Gravar o romaneio em um arquivo com out_path	não	sim

O limite é sobre remessas em andamento, não sobre saber o que há em uma caixa. Marcar uma lista como enviada ou cancelá-la libera seu espaço, e o mesmo acontece ao excluir um rascunho, então um usuário gratuito sempre pode voltar ao limite sem uma chave.

Obtenha Pro: https://mcp.zovo.one/buy/packing-list (pagamento único), ou todos os servidores por um preço em https://mcp.zovo.one/buy/bundle

Privacidade

Todos os dados permanecem locais, em ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/packing-list/. Não há nenhuma chamada de rede em qualquer lugar neste servidor, nenhuma chave de API e nenhuma conta. O único arquivo que ele lê e que não é de sua propriedade é o perfil de negócios compartilhado, para o nome e endereço no topo do romaneio, e ele nunca grava nele.

Construído por theluckystrike. Suporte: support@zovo.one

Use estes documentos como um servidor MCP

Qualquer cliente MCP (Claude, Cursor, Windsurf, VS Code) pode ler a documentação deste repositório diretamente via GitMCP — sem instalação:

• URL do MCP de documentação: https://gitmcp.io/theluckystrike/mcp-packing-list