可追踪二维码生成服务

Quality QR MCP Server 是一个通过AI助手创建和管理可追踪二维码的服务,提供扫描跟踪、分析和动态更新功能。

  • by silly-geese
  • 云端部署
  • 更新于
在 GitHub 查看 Unbelieva/quality-qr-mcp

使用说明

优质QR MCP服务器

通过人工智能助手(如Claude、Cursor和任何兼容MCP的工具)创建和管理可跟踪的二维码。

与通用二维码生成器不同,优质二维码 已保存到您的帐户 扫描跟踪、分析以及无需重新打印即可更新目的地的能力。

端点: https://quality-qr.app/api/mcp

设置

1.获取API密钥

注册地址: 质量-qr.app 并在生成API密钥 仪表板>设置>API键.

2.配置您的MCP客户端

Smithery用户: 如果您通过安装 史密瑟里,系统将提示您输入 apiKey 直接由Smithery处理 Authorization 标题为你。以下配置用于手动设置。

克劳德桌面版

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在Mac上):

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

光标

添加到光标MCP设置中:

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

克劳德代码

claude mcp add quality-qr --transport http https://quality-qr.app/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

3.开始使用它

问你的AI助手:

  • “创建二维码https://example.com"
  • “使用密码guest123为网络MyWiFi制作WiFi二维码”
  • “显示我的二维码分析”
  • “列出我的所有二维码”
  • “禁用二维码abc123”

可用工具

工具 说明
quality_qr_create 创建可追踪的二维码。12种类型:URL、PDF、菜单、应用商店、社交、WiFi、vCard、电子邮件、电话、短信、文本、事件。返回内联SVG。
quality_qr_list 列出您的二维码,可选类型过滤器和分页。
quality_qr_get 通过ID获取二维码的完整详细信息
quality_qr_update 更新目标URL(动态类型)、重命名或启用/禁用。
quality_qr_delete 永久删除二维码。释放计划配额。
quality_qr_analytics 扫描分析:总计、每日趋势、设备细分、主要国家。

二维码类型

动态(打印后可以更改URL): URL、PDF、菜单、应用商店、社交媒体

静态(数据直接编码): WiFi、vCard、电子邮件、电话、短信、文本、活动

速率限制

MCP工具调用计入您的API费率限制。协议消息(initialize, tools/list)是免费的。

计划 工具调用/月 分析历史 价格
免费 100 7天 免费
专业 1000 30天 10欧元/月
商业 10000 1年 30欧元/月

速率限制响应标头

每个响应都包含标题,以帮助您管理使用情况:

标题 描述
X-RateLimit-Limit 您的计划每月允许的最大工具调用次数
X-RateLimit-Remaining 当前计费期内剩余的工具调用
X-RateLimit-Reset 限制重置时的UTC时间戳(ISO 8601)
Retry-After 重试前等待的秒数(仅在 429 答复)

当你收到 429 Too Many Requests 响应,等待中指定的秒数 Retry-After 在重试之前。

安全

  • 通过API密钥(承载令牌)验证的所有请求
  • 可以从仪表板立即撤销密钥
  • 二维码仅限于您的帐户(无跨用户访问权限)
  • 未暴露任何管理、计费或团队管理操作
  • 符合GDPR和CCPA标准,托管在Cloudflare的全球边缘网络上

API密钥管理

您的API密钥可完全访问您的二维码和分析。把它当作密码。

  • 定期旋转。 在中生成新密钥 仪表板>设置>API键,更新MCP客户端配置,然后撤销旧密钥。您可以使用多个活动键来实现零停机轮换。
  • 立即撤销泄露的密钥。 撤销立即生效——任何使用旧密钥的飞行中请求都将失败。
  • 限制对配置文件的访问。 MCP客户端配置以明文形式存储您的密钥。在macOS/Linux上,确保只有您的用户可以读取它们(例如。, chmod 600).避免将带有真实密钥的配置文件提交到版本控制。

链接

协议

这是一个使用流式HTTP传输(JSON-RPC 2.0 over HTTP POST)的远程MCP服务器。无需本地安装。与MCP协议版本兼容 2025-03-26.