TheQRCode.io

TheQRCode.io MCP サーバー

Claude、Cursor、または任意の MCP クライアントから QR コードを生成し、スキャン分析を確認できます。

リモート HTTP サーバーです。インストールは不要です。 npm も Docker も Python も必要ありません。クライアントに URL を 1 つ指定するだけで、あとはリクエストできます。

https://mcp.theqrcode.io/mcp

公式 MCP Registry に io.theqrcode/qr-code-generator として掲載されています。

---

セットアップ

Claude Desktop

Settings → Developer → Edit Config：

{
  "mcpServers": {
    "theqrcode": {
      "url": "https://mcp.theqrcode.io/mcp"
    }
  }
}

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "theqrcode": {
      "url": "https://mcp.theqrcode.io/mcp"
    }
  }
}

API キーを使う場合（分析ツールが利用可能になります）

{
  "mcpServers": {
    "theqrcode": {
      "url": "https://mcp.theqrcode.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

ストリーミング可能な HTTP 経由で MCP 仕様に対応しているクライアントであれば、どれでも使用できます。設定を編集したらクライアントを再起動し、あとは「https://example.com の QR コードを生成して」と尋ねるだけです。

---

ツール

ツールは 3 つです。ディレクトリーのクローラーに実際の機能を認識してもらえるよう、匿名ユーザーを含むすべてのセッションに 3 つとも通知されます。ただし、アカウント関連の 2 つのツールは、キーがない場合、呼び出し時に拒否されます。

generate_qr_code — 無料、キー不要

Param	Type	Required	Notes
type	url | wifi | contact | text | email	はい	5 種類すべて無料、キー不要
content	string	はい	エンコードするデータ
name	string	いいえ	アカウントに保存する場合の表示名
size	int 64–1024	いいえ	デフォルトは 256
darkColor	#RRGGBB	いいえ	デフォルトは #000000
lightColor	#RRGGBB	いいえ	デフォルトは #FFFFFF
dotStyle	square | dots | rounded | extra-rounded | classy | classy-rounded	いいえ	モジュールの形状
cornerStyle	square | dot | extra-rounded	いいえ	3 つのコーナーの四角形
frameStyle	square | rounded | circle | dashed	いいえ	square はフレームなしを意味します
caption	string ≤60	いいえ	コードの下に表示するテキスト。指定するとフレームが付きます
format	png | svg | pdf	いいえ	デフォルトは png。svg/pdf にはキーが必要です

ホストされた画像 URL と、インライン表示用の base64 データ URL を返します。PDF は画像ではなく、また多くのクライアントでは SVG を描画できないため、svg と pdf は画像ブロックではなく、テキスト応答内のデータ URL として返されます。

すべてのデザインオプションは、すべてのプランでキーなしでも無料です。色、サイズ、ドットとコーナーのスタイル、フレーム、キャプションを利用でき、出力に透かしは入りません。ロゴの埋め込みも無料ですが、base64 データ URL が必要で、ツール呼び出しには適さないため、ここではパラメーターとして用意されていません。

format: "svg" | "pdf" だけが例外ですが、これは有料化ではなくコスト管理のためです。ベクター形式と PDF はレンダリングコストが最も高いため、IP ごとではなくキーごとに使用量が計測されます。どちらも、ダッシュボードと theqrcode.io の登録不要ジェネレーターでは、すべてのプランで無料です。

匿名 → 公開キー不要 API を使用します。IP ごとに 1 時間あたり 100 リクエストまでです。ホストされたリンクは24 時間のプレビューです。URL をブックマークするのではなく、画像をダウンロードしてください。QR コード自体に有効期限はありません。一時的なのはプレビューのホスティングです。

認証済み → v1 API を使用します。コードはアカウントに永続的に保存され、レート制限は IP ではなくキーごとに適用されます。また、format: "svg" | "pdf" が利用可能になります。

list_qr_codes — Developer プラン

アカウントに保存されたコードを一覧表示します。page、limit（1–100）、type で絞り込めます。

get_analytics — Developer プラン

アカウント全体または 1 つの qrCodeId のスキャン分析を取得します。timeRange：1h、1d、7d、30d（デフォルト）、90d、1y。

スキャン総数とユニークスキャン数、時刻、おおよその位置情報（IP から国・都市を推定。地域レベルであり、GPS ではありません）、デバイスと OS、キャンペーンを返します。静的 QR コードは追跡できません。分析には動的コードが必要です。

---

プラン

	匿名	Developer（$19/mo）	Pro（$29/mo）
generate_qr_code	✅ 全5種類、デザイン完全対応	✅ + svg/pdf 出力	✅ + svg/pdf 出力
アカウントへのコード保存	❌ 24時間のプレビューリンク	✅ 永続保存	✅ 永続保存
list_qr_codes	❌	✅	❌
get_analytics	❌	✅	❌
MCP のレート制限	IP ごとに 100/時	キーごとに 2,000/時	キーごとに 500/時

MCP の呼び出しもキーの REST API 制限である 5,000/時にカウントされます。MCP の制限はその範囲内での上限です。

API キー：https://theqrcode.io/pricing

---

自分で実行する

ホスト型サーバー mcp.theqrcode.io の利用が推奨される方法です。自分で実行する必要はありませんが、 必要であれば、これはシンプルな Express アプリです。

npm install
npm run build
npm run start:http # HTTP server on $PORT (or: npm run dev)
npm start          # one session over stdio, for a local client
npm test

stdio 経由の場合、THEQRCODE_API_KEY を設定するとアカウント用ツールを利用できます。設定しない場合はキー不要の機能を利用できます。

環境変数	デフォルト	用途
QR_API_BASE	https://theqrcode.io	このサーバーがラップする REST API
PORT	3001	リッスンポート（HTTP モード）
THEQRCODE_API_KEY	—	stdio モード用の API キー（HTTP ではリクエストごとに Bearer トークンとして受け取ります）

ルート：POST|GET|DELETE /mcp（ステートレス — リクエストごとに新しいサーバーとトランスポートを起動）、GET /health。

Docker：

docker build -t theqrcode-mcp .
docker run -p 3001:3000 -e PORT=3000 theqrcode-mcp

---

ラップ対象

TheQRCode.io は QR コードの生成と分析を行うプラットフォームです。URL、WiFi、vCard の連絡先、テキスト、メール用の静的および動的 QR コードに対応し、スキャンを時刻、デバイス、おおよその位置ごとに分析できます。 静的コードに有効期限はなく、アップグレードを強制するために印刷済みコードが無効化されることもなく、コードのデザインに料金が発生することもありません。

このサーバーは、利用方法の3つのうちの1つです。ほかに、 キー不要の REST API と OpenAI の関数呼び出しがあります。

• サイト — https://theqrcode.io
• REST API — https://theqrcode.io/qr-code-api
• OpenAPI 仕様 — https://theqrcode.io/api/public/qr-codes/openapi.json
• エージェントガイド — https://theqrcode.io/llms-full.txt

ライセンス

MIT — LICENSE を参照してください。