TheQRCode.io

TheQRCode.io MCP 服务

通过 Claude、Cursor 或任何 MCP 客户端生成二维码，并查看其扫描分析数据。

远程 HTTP 服务，无需安装。 不需要 npm、Docker 或 Python。只需让客户端连接到一个 URL，然后提出请求。

https://mcp.theqrcode.io/mcp

已列入官方 MCP Registry，名称为 io.theqrcode/qr-code-generator。

---

设置

Claude Desktop

设置 → 开发者 → 编辑配置：

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

Cursor

~/.cursor/mcp.json：

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

使用 API key（解锁分析工具）

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

任何支持通过可流式传输的 HTTP 使用 MCP 规范的客户端都可以使用。编辑配置后重启 客户端，然后直接提出请求：“为 https://example.com 生成二维码”。

---

工具

共三个工具。所有会话都会显示这三个工具，包括匿名会话，因此目录爬虫也能看到实际提供的工具；但没有 key 时，两个账户工具会在调用时拒绝请求。

generate_qr_code — 免费，无需 key

参数	类型	必填	说明
type	url | wifi | contact | text | email	是	五种类型均免费，无需 key
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	否	三个角上的方块样式
frameStyle	square | rounded | circle | dashed	否	square 表示无边框
caption	string ≤60	否	二维码下方的文字；设置后会添加边框
format	png | svg | pdf	否	默认值为 png；svg/pdf 需要 key

返回托管图片 URL 和用于内嵌显示的 base64 data URL。svg 和 pdf 会以文本响应中的 data URL 形式返回，而不是图片块，因为 PDF 不是图片，而且许多客户端无法渲染 SVG。

所有设计选项在所有套餐中都免费，且完全无需 key——颜色、尺寸、点和角的样式、边框和说明文字，所有输出都没有水印。付费套餐提供的是动态二维码、分析数据、存储二维码数量以及托管 API。嵌入 Logo 也免费，但这里不提供此参数：它需要 base64 data URL，不适合通过工具调用传递。

format: "svg" | "pdf" 是唯一的例外，这并非付费墙，而是成本控制措施：矢量图和 PDF 的渲染成本最高，因此按 key 而非 IP 计量。这两种格式在控制面板和 theqrcode.io 上无需注册的生成器中，所有套餐均可免费使用。

匿名使用 → 公共无 key API，每个 IP 每小时 100 次请求。托管链接是有效期为 24 小时的预览；请下载图片，不要收藏该 URL。二维码本身永不过期——临时的是预览图片的托管服务。

通过身份验证使用 → v1 API。二维码会永久保存到你的账户，限流按 key 而非 IP 计算，并且可以使用 format: "svg" | "pdf"。

list_qr_codes — Developer 套餐

列出保存到你账户的二维码。支持 page、limit（1–100）和 type 筛选。

get_analytics — Developer 套餐

查看账户整体或某个 qrCodeId 的扫描分析数据。timeRange：1h、1d、7d、30d （默认值）、90d、1y。

返回扫描总数和独立扫描数、时间、粗略位置（根据 IP 推断国家/城市，属于区域级位置， 而非 GPS 定位）、设备和操作系统，以及营销活动。静态二维码无法追踪；分析功能需要动态 二维码。

套餐

	匿名	Developer（$19/月）	Pro（$29/月）
generate_qr_code	✅ 全部 5 种类型，完整设计	✅ + svg/pdf 输出	✅ + svg/pdf 输出
保存到账号的二维码	❌ 24 小时预览链接	✅ 永久保存	✅ 永久保存
list_qr_codes	❌	✅	❌
get_analytics	❌	✅	❌
MCP 速率限制	每个 IP 每小时 100 次	每个密钥每小时 2,000 次	每个密钥每小时 500 次

MCP 调用也计入密钥每小时 5,000 次的 REST API 限额；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 是一个二维码生成与分析平台：支持为 URL、WiFi、vCard 联系人、文本和电子邮件生成静态及动态二维码，并按时间、设备和大致位置查看扫描分析数据。静态二维码永不过期，已打印的二维码不会被关闭以强制用户升级，二维码设计也永远不会单独收费。

此服务是三种接入方式之一，其他两种是 无需密钥的 REST API 和 OpenAI 函数调用。

• 网站 — https://theqrcode.io
• REST API — https://theqrcode.io/qr-code-api
• OpenAPI 规范 — https://theqrcode.io/api/public/qr-codes/openapi.json
• Agent 指南 — https://theqrcode.io/llms-full.txt

许可证

MIT — 详见 LICENSE。