barcode

mcp-barcode

在当前对话中生成二维码或条形码。粘贴一个 URL，即可获得可放在传单上的二维码。为客户的发票生成 EPC 付款码，让对方的银行应用扫描后自动填写信息。为产品生成 EAN-13 条形码，为货架标签生成 Code 128 条形码，为办公室墙面生成 WiFi 码，为会议胸牌生成 vCard。所有内容都在你的机器上生成：无需上传、无需账户、无需 API 密钥，也不会进行任何网络请求。

收录于官方 MCP Registry（io.github.theluckystrike/barcode-qr-code-sepa-payment-ean13）。

已列入 AI Product Index——提供实时远程端点：mcp.zovo.one/s/barcode，免费套餐，无需注册。

@theluckystrike/mcp-barcode 的 npm 发布仍在等待中，因此目前运行 npx -y @theluckystrike/mcp-barcode 会返回 404。在此期间，可用的方式是使用 .mcpb 一键安装包，或克隆并构建。

安装

Claude Desktop，~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %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"] }
  }
}

工具

工具	功能
qr_create	将文本或 URL 生成为二维码，可选择任意纠错级别，支持 SVG 或 PNG
qr_wifi	扫描后即可加入 WiFi 网络的二维码
qr_vcard	添加联系人（vCard 3.0）的二维码
qr_payment_sepa	欧元区银行应用可扫描的 EPC069-12 付款码：IBAN、姓名、金额、附言
invoice_payment_qr	发票付款码，使用你共享的企业资料中的 IBAN 和姓名
barcode_create	生成 Code 128、EAN-13、EAN-8 或 UPC-A 条形码，并计算或验证校验位
barcode_batch	一次调用生成多个码并保存到目录中（Pro）
code_list	查看已生成的码，以及本月免费额度的剩余数量
license_status、license_activate	查看 Free 或 Pro 许可，并激活密钥

Free 与 Pro

	Free	Pro
每个自然月可生成的码数	20	不限
SVG（可按任意尺寸打印）	是	是
PNG	否	是，32 至 4000 px
barcode_batch	否	是，每次最多 500 行
QR、WiFi、vCard、SEPA 付款码，以及全部四种条码制式	是	是

获取 Pro：**https://mcp.zovo.one/buy/barcode**——一次性支付 $19，或支付 $39 购买套件中所有服务的终身许可。 密钥可离线验证；不会向任何地方发送数据。

校验位错误时会拒绝生成，而非重新绘制

向 barcode_create 提供 12 位数字，它会为你计算第 13 位。提供 13 位数字时，第 13 位会被校验：

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.

另一种做法是悄悄重绘调用方要求的码，但这样打印出来的标签扫描后会显示为另一个产品，直到收银台结账时才会有人发现。付款码中的 IBAN 也遵循同样的规则：绘制前会按照 ISO 7064 mod 97 进行验证，因此数字换位的问题会在这里被发现，而不是等到付款失败时才发现。

实测：对于 SEPA 支付码，纠错级别 M 不增加成本，Q 和 H 则会

一条典型的 EPC 支付记录（IBAN、收款人、EUR 120.50、发票编号）为 73 字节。二维码的容量按固定档位递增，因此提高纠错级别不会让码的尺寸平滑增长：

级别	可恢复	QR 版本	每边模块数	变化
L	7%	4	33	基准
M	15%	4	33	完全没有变化
Q	25%	6	41	+24%
H	30%	7	45	+36%

L 和 M 都落在版本 4 的符号中：对于这个负载大小，额外的恢复数据仍然能装进同样大小的方框，因此选择 L 而不是 M 没有任何好处，还会损失一半的损坏容忍度。这就是这里将 M 设为默认值的原因。只有当二维码会被印得很小、印在容易折皱的东西上，或被徽标遮挡时，才值得考虑 Q 和 H。在 300 px 的 PNG 上，提高级别也会增加字节数：M 为 2,419 字节，H 为 3,462 字节。

实测：SVG 大小稳定，PNG 增长 14 倍，两者在约 200 px 时交叉

同一个支付码以两种格式分别写入，并使用五种尺寸：

请求尺寸	PNG 字节数	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

SVG 保存的是模块网格，而不是像素，因此它的大小几乎不会变化：1024 px 时多出的 2 个字节，是因为 width 属性变长了。低于约 200 px 时，PNG 更小；超过这个尺寸后，PNG 会不断增大，而 SVG 不会。打印机放大 SVG 时，它仍能保持清晰。这就是免费套餐提供 SVG，而不是小尺寸 PNG 的原因：对于大多数人使用二维码的方式——将它放进文档并打印——SVG 是更好的文件格式，而不是退而求其次的选择。

隐私

所有内容都留在你的设备上。此服务中完全没有网络代码：没有 fetch、没有 HTTP 客户端、没有遥测。二维码会写入你指定的位置，生成记录的小型登记册保存在 ~/.local/share/mcp-servers/barcode/（或 $XDG_DATA_HOME）下。许可证密钥通过公钥离线验证。

由 theluckystrike 构建。支持邮箱：[email protected]

将这些文档用作 MCP 服务

任何 MCP 客户端（Claude、Cursor、Windsurf、VS Code）都可以通过 GitMCP 直接读取此代码库的文档，无需安装：

• 文档 MCP URL：https://gitmcp.io/theluckystrike/mcp-barcode