qr-barcode-wifi-vcard-sepa

mcp-barcode

今いる会話の中で、QR コードやバーコードを作成できます。URL を貼り付ければ、チラシに載せられる QR コードが作成できます。顧客の請求書に、銀行アプリでスキャンすると支払い情報が入力される 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 を、任意の誤り訂正レベルで QR コードに変換します。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	無料版または Pro のライセンス状態の確認と、キーの有効化を行います

無料版と Pro

	無料版	Pro
1 か月あたりのコード数	20	無制限
SVG（任意のサイズで印刷可能）	はい	はい
PNG	いいえ	はい、32～4000 px
barcode_batch	いいえ	はい、1 回あたり最大 500 行
QR、WiFi、vCard、SEPA 支払いコード、4 種類すべてのバーコードシンボル	はい	はい

Pro の購入先：https://mcp.zovo.one/buy/barcode - 1 回限りの購入は $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 コードの容量は段階的に固定されているため、誤り訂正レベルを上げてもコードのサイズが滑らかに大きくなるわけではありません。

レベル	復元可能率	QR バージョン	1 辺のモジュール数	変化
L	7%	4	33	基準
M	15%	4	33	まったく変化なし
Q	25%	6	41	+24%
H	30%	7	45	+36%

L と M は同じバージョン 4 のシンボルになります。このペイロードサイズでは、追加の復元データも同じ枠内に収まるため、M ではなく L を選んでも何も得られず、耐損傷性が半減します。そのため、ここでは M がデフォルトです。Q と H を選ぶ価値があるのは、コードを小さく印刷する場合、折り目がつくものに印刷する場合、またはロゴを重ねる場合に限られます。300 px の PNG でも、レベルを上げるとバイト数が増えます。M では 2,419 バイト、H では 3,462 バイトです。

実測：SVG のサイズはほぼ一定、PNG は 14 倍に増大し、約 200 px で大小が逆転します

同じ決済コードを 2 つの形式で、5 種類のサイズで出力した結果です。

要求サイズ	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 バイト増えるのは、幅属性の文字数が増えるためです。およそ 200 px 未満では PNG のほうが小さくなります。それを超えると PNG は際限なく大きくなりますが、SVG は変わりません。また、プリンターで拡大しても鮮明さを保てるのは SVG です。これが、無料プランを小さい PNG ではなく SVG にしている理由です。コードの一般的な用途である、文書に挿入して印刷する用途では、SVG のほうが優れたファイル形式であり、代替品ではありません。

プライバシー

すべての処理はお使いのマシン上で完結します。このサーバーにはネットワーク関連のコードが一切ありません。fetch も HTTP クライアントもテレメトリーもありません。コードは指定した場所に書き込まれ、生成した内容の簡易レジスターは ~/.local/share/mcp-servers/barcode/（または $XDG_DATA_HOME）に保存されます。ライセンスキーは公開鍵を使ってオフラインで検証されます。

theluckystrike が開発しました。サポート：[email protected]

これらのドキュメントを MCP サーバーとして使用する

どの MCP クライアント（Claude、Cursor、Windsurf、VS Code）でも、インストールせずに GitMCP 経由でこのリポジトリのドキュメントを直接読み取れます。

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