payqr

@czagents/payqr

欧州の決済QRコード — SPAYD（CZ/SK）とEPC/GiroCode（ユーロ圏）の決済QRコードに加え、標準的なQRコード（テキスト、Wi-Fi、vCard）の生成と読み取りができます。銀行アプリでスキャンするだけで、振込情報を入力できます。ローカルで動作し、データがデバイスの外に送信されることはありません。無料です。

SPAYD（チェコ／スロバキア）とEPC / GiroCode（SEPA）の決済QRコードに加え、 プレーンテキスト、Wi-Fi、vCardのQRコードを確定的に生成し、画像からQRコードを読み取ることもできます。

無料、MITライセンス、AIも有料APIも不要です。すべてローカルで処理され、データが外部に送信されることはありません。

💡 ブラウザーで使いたいですか？同じエンジンを、無料のウェブアプリ https://qr.cz-agents.dev として利用できます — 詳細を入力するか、決済のスクリーンショット／QRコードをドロップしてください。すべてクライアント側で処理されます。

理由

ブローカーの入金案内（Revolut、Trading 212、XTB、請求書など）からIBAN、金額、変動シンボルをコピーして、銀行アプリに手入力するのは時間がかかり、間違いも起きやすい作業です。数字を1桁間違えるだけで、誤った口座に送金してしまいます。このサーバーは、そうした情報を銀行アプリで直接読み取れるスキャン可能な決済QRコードに変換します。また、既存の決済QRコードを読み取って、構造化されたフィールドに戻すこともできます。

インストール

MCP クライアント（Claude Desktop の claude_desktop_config.json など）に追加します。

{
  "mcpServers": {
    "payqr": {
      "command": "npx",
      "args": ["-y", "@czagents/payqr"]
    }
  }
}

または、直接実行します。

npx -y @czagents/payqr        # stdio transport

ツール

各例は、MCP ツール呼び出しの引数オブジェクトです。

• qr_payment — 決済QRコードを作成します。CZ/SK の IBAN には SPAYD を、その他の SEPA IBAN には EPC/GiroCode を選択します。画像から抽出した決済情報は、ユーザーが読み取り結果のフィールドを確認するまで使用しないでください。EPC では recipient_name も必要です。例：{"iban":"CZ6508000000192000145399","amount":1500,"currency":"CZK","variable_symbol":"1234567890","message":"Invoice 2026-001"}。
• qr_text — プレーンテキストを含むQRコードを作成します。専用ツールが適切な構造化決済、Wi-Fi設定、連絡先には使用しないでください。例：{"text":"https://cz-agents.dev"}。
• qr_wifi — WPA、WEP、またはオープンネットワーク用のWi-FiネットワークQRコードを作成します。ネットワークへのアクセスを許可すべきでない相手に、認証情報を共有するためには使用しないでください。例：{"ssid":"Office WiFi","password":"correct-horse-battery-staple","security":"WPA","hidden":false}。
• qr_vcard — vCard 3.0 の連絡先QRコードを作成します。含める個人情報の共有に連絡先本人が同意していない場合は使用しないでください。例：{"name":"Ada Lovelace","phone":"+420123456789","email":"[email protected]","org":"Analytical Engines"}。
• qr_read — base64 PNG/JPEG 形式の既存QR画像をデコードし、分類します。このサーバーで生成したQRコードはすでに自己検証済みのため、検証目的では使用しないでください。また、デコードに失敗した場合、その決済が検証済みだと見なさないでください。例：{"image_data":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUg..."}。
• qr_payment_batch (有料。x402 が設定されている場合に利用可能) — 1回の請求処理で最大50件の決済QRコードを生成し、検証します。1件の決済には使用しないでください。また、x402 の支払い条件を確認する前に使用しないでください。例：{"payments":[{"ref":"INV-001","iban":"CZ6508000000192000145399","amount":1500,"currency":"CZK","variable_symbol":"2026001"}]}。

各生成ツールは、レンダリングされたQRの画像と、エンコードされた ペイロード、選択された規格、警告を含むテキストブロックの両方を返します。そのため、クライアントはQRをネイティブに表示でき、エンコード内容を正確に確認できます。

IBANforge 紹介リンク（任意）

成功した qr_payment の応答、および1件以上のQRを生成した有料バッチ応答には、任意の next_steps 紹介情報を含めることができます。デフォルトでは無効です。有効にするには、次の3つの変数すべてを設定します。

IBANFORGE_REFERRAL_ENABLED=true
IBANFORGE_REFERRAL_URL=https://ibanforge.com/?src=payqr
IBANFORGE_REFERRAL_RELATIONSHIP=unpaid_partner # or affiliate

URLはHTTPSを使用し、ibanforge.com またはそのサブドメインに属している必要があります。有効化された設定が無効な場合、サーバーは起動時に停止します。紹介URLにIBAN、金額、参照情報、その他の決済データが含まれることはありません。無料の決済以外のツール、失敗した決済、未払いのx402応答には紹介情報は含まれません。アフィリエイト関係は、返される文面で明示されます。

画像からの支払いワークフロー

支払い情報のスクリーンショットや写真を貼り付けると、アシスタントが画像から IBAN、金額、通貨、受取人、照会番号を読み取り、qr_payment を呼び出します。QR コードを表示する前に、抽出した項目を読み上げ、元の情報と照合して確認できるようにします。読み間違えた数字ひとつで、実際のお金が誤った相手に送られる可能性があるためです。確認後にのみ、コードを提示します。

規格

• SPAYD（SPD*1.0*…） — チェコとスロバキアの銀行アプリで読み取れる、チェコ／スロバキアの「QR Platba」文字列形式です。
• EPC / GiroCode（BCD…） — SEPA クレジット振込用の QR 規格（EPC069-12）です。ユーロのみ対応で、ドイツ、オーストリアをはじめユーロ圏全域で広く使われています。受取人名が必要です。

プライバシー

テレメトリーなし、QR コード生成のためのネットワーク通信なし、AI なし。すべてローカルで処理します。

ライセンス

MIT © cz-agents