Zovo Barcode MCP Server

mcp-barcode

Crie um QR code ou um código de barras na conversa em que você já está. Cole uma URL e obtenha um QR code que você pode colocar em um panfleto. Dê à fatura de um cliente um código de pagamento EPC que o aplicativo bancário dele escaneia e preenche para ele. Imprima um EAN-13 para um produto, um Code 128 para uma etiqueta de prateleira, um código WiFi para a parede do escritório, um vCard para um crachá de conferência. Tudo é desenhado na sua máquina: sem upload, sem conta, sem chave de API e sem nenhuma chamada de rede.

No Registro Oficial de MCP (io.github.theluckystrike/barcode-qr-code-sepa-payment-ean13).

Listado no Índice de Produtos de IA - endpoint remoto ao vivo em mcp.zovo.one/s/barcode, plano gratuito, sem cadastro.

A publicação no npm para @theluckystrike/mcp-barcode está pendente, então npx -y @theluckystrike/mcp-barcode retorna 404 hoje. Até lá, o pacote de um clique .mcpb ou um clone + build é o caminho que funciona.

Instalação

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

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

Claude Code:

claude mcp add barcode -- npx -y @theluckystrike/mcp-barcode

Cursor, .cursor/mcp.json:

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

Ferramentas

ferramenta	o que faz
qr_create	Texto ou URL como QR code, em qualquer nível de correção de erros, SVG ou PNG
qr_wifi	Um código que se conecta a uma rede WiFi quando escaneado
qr_vcard	Um código que adiciona um contato (vCard 3.0)
qr_payment_sepa	Um código de pagamento EPC069-12 que um aplicativo bancário europeu escaneia: IBAN, nome, valor, referência
invoice_payment_qr	O código de pagamento para uma fatura, usando o IBAN e o nome do seu perfil comercial compartilhado
barcode_create	Code 128, EAN-13, EAN-8 ou UPC-A, com o dígito verificador calculado ou verificado
barcode_batch	Muitos códigos em uma única chamada, em um diretório (Pro)
code_list	O que você gerou e quanto da cota gratuita deste mês ainda resta
license_status, license_activate	Gratuito ou Pro, e ativação de uma chave

Gratuito vs Pro

	Gratuito	Pro
Códigos por mês calendário	20	Ilimitado
SVG (imprime em qualquer tamanho)	Sim	Sim
PNG	Não	Sim, de 32 a 4000 px
barcode_batch	Não	Sim, até 500 linhas por chamada
QR, WiFi, vCard, códigos de pagamento SEPA, todas as quatro simbologias de código de barras	Sim	Sim

Obtenha o Pro: https://mcp.zovo.one/buy/barcode - US$ 19 pagamento único, ou US$ 39 para todos os servidores do pacote, vitalício. As chaves são verificadas offline; nada é enviado a lugar nenhum.

Um dígito verificador errado é recusado, não redesenhado

Dê ao barcode_create doze dígitos e o décimo terceiro é calculado para você. Dê treze e o décimo terceiro é verificado:

Error: EAN-13 check digit is wrong: "5901234123450" ends in 0, but the first 12 digits give 7.
Pass 5901234123457, or pass the first 12 digits and the check digit is computed. Nothing was written.

A alternativa, redesenhar silenciosamente o código que o chamador pediu, imprime uma etiqueta que escaneia como um produto diferente, e ninguém descobre até o caixa. A mesma regra se aplica ao IBAN em um código de pagamento: ele é validado com ISO 7064 mod 97 antes que qualquer coisa seja desenhada, então um par de dígitos transpostos é detectado aqui em vez de por um pagamento que não vai a lugar nenhum.

Medido: correção de erros M é gratuita em um código de pagamento SEPA, Q e H não são

Um registro de pagamento EPC típico (IBAN, beneficiário, EUR 120,50, um número de fatura) tem 73 bytes. QR codes vêm em etapas de capacidade fixa, então aumentar o nível de correção de erros não aumenta o tamanho do código suavemente:

nível	recuperável	versão QR	módulos por lado	mudança
L	7%	4	33	linha de base
M	15%	4	33	nenhuma mudança
Q	25%	6	41	+24%
H	30%	7	45	+36%

L e M caem no mesmo símbolo versão 4: neste tamanho de carga útil, os dados extras de recuperação ainda cabem na mesma caixa, então escolher L em vez de M não compra nada e abre mão de metade da tolerância a danos. É por isso que M é o padrão aqui. Q e H valem a pena pedir apenas quando o código será impresso pequeno, em algo que amassa, ou atrás de um logotipo. Em um PNG de 300 px, o mesmo passo também custa bytes: 2.419 em M contra 3.462 em H.

Medido: SVG é plano, PNG cresce 14x, e eles se cruzam em cerca de 200 px

O mesmo código de pagamento escrito das duas formas, em cinco tamanhos:

tamanho solicitado	bytes PNG	bytes SVG
128 px	1.481	2.079
256 px	2.186	2.079
512 px	3.589	2.079
1024 px	7.585	2.081
2048 px	21.688	2.081

Um SVG carrega a grade de módulos, não os pixels, então seu tamanho mal se move: os dois bytes extras em 1024 px são o atributo de largura ficando mais longo. Abaixo de cerca de 200 px, um PNG é menor; acima disso, o PNG cresce sem limite e o SVG não, e o SVG é o que permanece nítido quando uma impressora o amplia. Essa é a razão pela qual o nível gratuito é o nível SVG em vez de um nível de PNG pequeno: para o que a maioria das pessoas faz com um código, colocá-lo em um documento e imprimi-lo, SVG é o arquivo melhor, não o prêmio de consolação.

Privacidade

Tudo permanece na sua máquina. Não há código de rede neste servidor: sem fetch, sem cliente HTTP, sem telemetria. Os códigos são gravados onde você indicar, e um pequeno registro do que foi gerado fica em ~/.local/share/mcp-servers/barcode/ (ou $XDG_DATA_HOME). As chaves de licença são verificadas offline com uma chave pública.

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 MCP dos documentos: https://gitmcp.io/theluckystrike/mcp-barcode