Quality QR

io.github.silly-geese由 GitHub 帳號 silly-geese 發布v1.0.0更新於 Nov 2, 2026

Create and manage trackable QR codes with scan tracking, analytics, and dynamic URL updates.

已驗證Streamable HTTP可網頁執行資料與分析商業與電商媒體與設計

概覽

AI 產生的概覽

遠端 MCP 伺服器，可在 Quality QR 帳號中建立與管理可追蹤的 QR 碼，支援掃描統計與目標連結修改。

可以做什麼
  • 建立 12 種 QR 碼（網址、PDF、菜單、應用程式商店、社群、WiFi、名片、電子郵件、電話、簡訊、文字、活動），並回傳內嵌 SVG
  • 列出並檢視已儲存的 QR 碼，包含類型、短網址、啟用狀態與設計設定
  • 重新命名 QR 碼、啟用或停用，並修改動態網址類型的目標連結
  • 永久刪除 QR 碼，同時釋出方案配額
  • 讀取掃描統計：總次數、每日趨勢、裝置分布與主要國家
適用情境
適合需要產生可隨時修改且可衡量成效的 QR 碼時使用，例如印刷菜單、海報或包裝上的連結日後可能變更，以及想查看這些 QR 碼被掃描的情況。
執行需求
遠端 Streamable HTTP 端點，無需本機安裝。需要 Quality QR 帳號，並在後台產生 API 金鑰，透過 Authorization Bearer 標頭傳送。工具呼叫會計入每月方案配額（免費方案 100 次呼叫，統計歷史 7 天）。
安裝前請注意
API 金鑰可完整存取你的 QR 碼與統計資料，且 MCP 用戶端設定以明文儲存金鑰，應限制檔案權限並避免提交到版本控制。建立、更新與刪除會變更帳號資料；刪除無法復原，短網址會立即停止轉址。掃描資料由該服務儲存，付費方案按月計費。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Quality QR，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.silly-geese%2Fquality-qr/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "quality-qr": {
      "type": "http",
      "url": "https://quality-qr.app/api/mcp"
    }
  }
}

README

Quality QR MCP Server

[Validate manifests] [Smithery] [MCP] [Protocol] [License]

Create and manage trackable QR codes through AI assistants like Claude, Cursor, and any MCP-compatible tool.

Unlike generic QR code generators, Quality QR codes are saved to your account with scan tracking, analytics, and the ability to update destinations without reprinting.

Endpoint: https://quality-qr.app/api/mcp

Setup

1. Get an API Key

Sign up at quality-qr.app and generate an API key at Dashboard > Settings > API Keys.

2. Configure Your MCP Client

Smithery users: If you install via Smithery, you'll be prompted for your apiKey directly — Smithery handles the Authorization header for you. The configs below are for manual setup.

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on Mac):

json
{  "mcpServers": {    "quality-qr": {      "url": "https://quality-qr.app/api/mcp",      "headers": {        "Authorization": "Bearer YOUR_API_KEY"      }    }  }}
Cursor

Add to your Cursor MCP settings:

json
{  "mcpServers": {    "quality-qr": {      "url": "https://quality-qr.app/api/mcp",      "headers": {        "Authorization": "Bearer YOUR_API_KEY"      }    }  }}
Claude Code
bash
claude mcp add quality-qr --transport http https://quality-qr.app/api/mcp \  --header "Authorization: Bearer YOUR_API_KEY"

3. Start Using It

Ask your AI assistant:

  • "Create a QR code for https://example.com"
  • "Make a WiFi QR code for network MyWiFi with password guest123"
  • "Show me the analytics for my QR codes"
  • "List all my QR codes"
  • "Disable QR code abc123"

Available Tools

ToolDescription
quality_qr_createCreate a trackable QR code. 12 types: URL, PDF, Menu, App Store, Social, WiFi, vCard, Email, Phone, SMS, Text, Event. Returns an inline SVG.
quality_qr_listList your QR codes with optional type filter and pagination.
quality_qr_getGet full details of a QR code by ID.
quality_qr_updateUpdate destination URL (dynamic types), rename, or enable/disable.
quality_qr_deletePermanently delete a QR code. Frees plan quota.
quality_qr_analyticsScan analytics: totals, daily trends, device breakdown, top countries.

QR Code Types

Dynamic (URL can be changed after printing): URL, PDF, Menu, App Store, Social

Static (data encoded directly): WiFi, vCard, Email, Phone, SMS, Text, Event

Rate Limits

MCP tool calls count against your API rate limit. Protocol messages (initialize, tools/list) are free.

PlanTool Calls / MonthAnalytics HistoryPrice
Free1007 daysFree
Pro1,00030 days€10/mo
Business10,0001 year€30/mo

Rate-Limit Response Headers

Every response includes headers to help you manage usage:

HeaderDescription
X-RateLimit-LimitMaximum tool calls allowed per month on your plan
X-RateLimit-RemainingTool calls remaining in the current billing period
X-RateLimit-ResetUTC timestamp when the limit resets (ISO 8601)
Retry-AfterSeconds to wait before retrying (only present on 429 responses)

When you receive a 429 Too Many Requests response, wait for the number of seconds specified in Retry-After before retrying.

Security

  • All requests authenticated via API key (Bearer token)
  • Keys can be revoked instantly from the dashboard
  • QR codes are scoped to your account (no cross-user access)
  • No admin, billing, or team management operations exposed
  • GDPR and CCPA compliant, hosted on Cloudflare's global edge network
  • See SECURITY.md to report a vulnerability, and PRIVACY.md for data handling details

API Key Management

Your API key grants full access to your QR codes and analytics. Treat it like a password.

  • Rotate regularly. Generate a new key in Dashboard > Settings > API Keys, update your MCP client config, then revoke the old key. You can have multiple active keys to allow zero-downtime rotation.
  • Revoke compromised keys immediately. Revocation takes effect instantly — any in-flight requests using the old key will fail.
  • Restrict access to config files. MCP client configs store your key in plaintext. On macOS/Linux, ensure only your user can read them (e.g., chmod 600). Avoid committing config files with real keys to version control.

Links

Protocol

This is a remote MCP server using Streamable HTTP transport (JSON-RPC 2.0 over HTTP POST). No local installation required. Compatible with MCP protocol version 2025-03-26.

來源：README.md，提交 838edeb

工具

6

quality_qr_create

Create a new trackable QR code saved to your Quality QR account. Use this when the user wants to generate a QR code for a URL, WiFi network, contact card, calendar event, phone number, email, SMS, restaurant menu, app download link, or social media profile. The QR code is persisted with scan tracking and analytics. Returns an inline SVG image of the QR code.

輸入參數datanametype必填designdomaincontentisDynamic

quality_qr_list

List QR codes in the user's Quality QR account. Use this when the user wants to see their existing QR codes, find a specific code, or check how many codes they have. Returns ID, name, type, short URL, active status, and creation date for each code.

輸入參數typelimitoffset

quality_qr_get

Get full details of a specific QR code by its ID. Use this when the user wants to inspect a particular QR code's configuration, check its destination URL, view its design settings, or see its current status. Returns all metadata including content, destination, design, scan limits, and timestamps.

輸入參數id必填

quality_qr_update

Update an existing QR code's properties. Use this when the user wants to change where a QR code points to, rename it, or enable/disable it. Destination URL changes only work for dynamic URL-based types (url, pdf, menu, app-store, social). Name and active status can be changed for any QR code type.

輸入參數id必填nameisActivedestinationUrl

quality_qr_delete

Permanently delete a QR code from the user's account. Use this when the user wants to remove a QR code they no longer need. The short URL will immediately stop redirecting. This action frees up a plan quota slot and cannot be undone.

輸入參數id必填

quality_qr_analytics

Get scan analytics for a specific QR code. Use this when the user wants to know how many times a QR code has been scanned, see daily scan trends, understand which devices are scanning, or see which countries scans come from. Returns total scans, scans by day, device breakdown (mobile/tablet/desktop), and top 5 countries.

輸入參數id必填days

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。