Barcode MCP

mcp-barcode

Servidor MCP para generación de códigos QR y códigos de barras: genera códigos de barras y códigos QR. Los códigos QR y códigos de barras se dibujan en tu máquina, sin subidas ni llamadas de red.

Funciona con Claude Desktop, Claude Code, Cursor y cualquier cliente del Model Context Protocol. Se ejecuta en tu propia máquina, o se aloja sin necesidad de instalación.

Página del producto: https://mcp.zovo.one/s/barcode — qué hace, las herramientas que expone y un endpoint de token en vivo.

Instalación

Alojado, sin nada que instalar. Obtén un token de https://mcp.zovo.one/mcp/connect (la página de conexión) o https://mcp.zovo.one/mcp/token (el mismo token en JSON); se emite uno anónimo gratuito al instante y una clave Pro funciona de la misma manera. Luego apunta un cliente MCP a https://mcp.zovo.one/mcp/barcode a través de streamable-http y envía el token como Authorization: Bearer <token>.

Si tu cliente no puede configurar cabeceras, coloca el token en la ruta en su lugar: https://mcp.zovo.one/mcp/barcode/t/<token>. Ambas formas funcionan. La URL sin token responde 401 en tools/call, por lo que el token no es opcional.

Claude Desktop, un clic. Descarga barcode.mcpb desde la última versión y haz doble clic en él.

Desde el código fuente. El espejo es autónomo: cada dependencia de @theluckystrike/* está incluida, por lo que un clon nuevo se compila sin configuración adicional.

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

Luego apunta tu cliente al punto de entrada compilado:

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

@theluckystrike/mcp-barcode aún no está publicado en npm, por lo que un comando npx -y @theluckystrike/mcp-barcode fallará. Las tres rutas anteriores son las que funcionan y cada una es probada por CI.

Espejo de solo lectura de mcp-servers/servers/barcode. Consulta MIRROR.md.

Crea un código QR o un código de barras en la conversación en la que ya estás. Pega una URL y obtén un código QR que puedes poner en un volante. Dale a la factura de un cliente un código de pago EPC que su aplicación bancaria escanea y completa por ellos. Imprime un EAN-13 para un producto, un Code 128 para una etiqueta de estante, un código WiFi para la pared de la oficina, una vCard para una credencial de conferencia. Todo se dibuja en tu máquina: sin subidas, sin cuenta, sin clave de API y sin ninguna llamada de red.

En el Registro oficial de MCP (io.github.theluckystrike/barcode-qr-code-sepa-payment-ean13).

Listado en el Índice de Productos de IA — endpoint remoto en vivo en mcp.zovo.one/s/barcode, nivel gratuito, sin registro.

La publicación en npm de @theluckystrike/mcp-barcode está pendiente, por lo que npx -y @theluckystrike/mcp-barcode devuelve 404 hoy. Hasta entonces, el paquete de un clic .mcpb o un clon+compilación es la ruta que funciona.

Instalación

Claude Desktop, ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %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"] }
  }
}

Herramientas

herramienta	qué hace
qr_create	Texto o una URL como código QR, en cualquier nivel de corrección de errores, SVG o PNG
qr_wifi	Un código que se une a una red WiFi al escanearse
qr_vcard	Un código que añade un contacto (vCard 3.0)
qr_payment_sepa	Un código de pago EPC069-12 que escanea una aplicación bancaria europea: IBAN, nombre, importe, referencia
invoice_payment_qr	El código de pago para una factura, usando el IBAN y el nombre de tu perfil empresarial compartido
barcode_create	Code 128, EAN-13, EAN-8 o UPC-A, con el dígito de verificación calculado o verificado
barcode_batch	Muchos códigos en una sola llamada, en un directorio (Pro)
code_list	Lo que has generado y cuánto del límite gratuito de este mes queda
license_status, license_activate	Gratis o Pro, y activación de una clave

Gratis vs Pro

	Gratis	Pro
Códigos por mes calendario	20	Ilimitado
SVG (imprime a cualquier tamaño)	Sí	Sí
PNG	No	Sí, de 32 a 4000 px
barcode_batch	No	Sí, hasta 500 filas por llamada
QR, WiFi, vCard, códigos de pago SEPA, las cuatro simbologías de códigos de barras	Sí	Sí

Obtén Pro: https://mcp.zovo.one/buy/barcode - $19 una sola vez, o $39 por todos los servidores de la suite, de por vida. Las claves se verifican sin conexión; no se envía nada a ningún sitio.

Un dígito de verificación incorrecto se rechaza, no se redibuja

Dale a barcode_create doce dígitos y el decimotercero se calcula por ti. Dale trece y el decimotercero se verifica:

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.

La alternativa, redibujar silenciosamente el código que el llamador pidió, imprime una etiqueta que se escanea como un producto diferente, y nadie se entera hasta la caja. La misma regla se aplica al IBAN en un código de pago: se valida con ISO 7064 mod 97 antes de dibujar cualquier cosa, por lo que un par de dígitos transpuestos se detecta aquí en lugar de por un pago que no llega a ninguna parte.

Medido: la corrección de errores M es gratuita en un código de pago SEPA, Q y H no lo son

Un registro de pago EPC típico (IBAN, beneficiario, EUR 120,50, un número de factura) tiene 73 bytes. Los códigos QR vienen en pasos de capacidad fijos, por lo que aumentar el nivel de corrección de errores no aumenta el tamaño del código de manera uniforme:

nivel	recuperable	versión QR	módulos por lado	cambio
L	7%	4	33	línea base
M	15%	4	33	sin cambio alguno
Q	25%	6	41	+24%
H	30%	7	45	+36%

L y M caen en el mismo símbolo de versión 4: con este tamaño de carga útil, los datos de recuperación adicionales aún caben en la misma caja, por lo que elegir L sobre M no compra nada y renuncia a la mitad de la tolerancia al daño. Por eso M es el valor predeterminado aquí. Q y H valen la pena solo cuando el código se imprimirá pequeño, en algo que se arruga, o detrás de un logotipo. En un PNG de 300 px, el mismo paso también cuesta bytes: 2,419 en M frente a 3,462 en H.

Medido: SVG es plano, PNG crece 14 veces, y se cruzan a unos 200 px

El mismo código de pago escrito de ambas maneras, en cinco tamaños:

tamaño 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

Un SVG lleva la cuadrícula de módulos, no los píxeles, por lo que su tamaño apenas se mueve: los dos bytes adicionales a 1024 px son el atributo de ancho que se vuelve más largo. Por debajo de aproximadamente 200 px, un PNG es más pequeño; por encima, el PNG crece sin límite y el SVG no, y el SVG es el que permanece nítido cuando una impresora lo escala. Esa es la razón por la que el nivel gratuito es el nivel SVG en lugar de un nivel de PNG pequeño: para lo que la mayoría de la gente hace con un código, ponerlo en un documento e imprimirlo, SVG es el mejor archivo, no el premio de consolación.

Privacidad

Todo permanece en tu máquina. No hay código de red en este servidor en absoluto: sin fetch, sin cliente HTTP, sin telemetría. Los códigos se escriben donde tú dices, y un pequeño registro de lo que se generó vive bajo ~/.local/share/mcp-servers/barcode/ (o $XDG_DATA_HOME). Las claves de licencia se verifican sin conexión con una clave pública.

Construido por theluckystrike. Soporte: support@zovo.one

Usa estos documentos como un servidor MCP

Cualquier cliente MCP (Claude, Cursor, Windsurf, VS Code) puede leer la documentación de este repositorio directamente a través de GitMCP — sin instalación:

• URL de documentos MCP: https://gitmcp.io/theluckystrike/mcp-barcode