内容
# @qr-maker/mcp-server
[](https://glama.ai/mcp/servers/qr-maker-io/mcp-server)
[](https://www.npmjs.com/package/@qr-maker/mcp-server)
MCP（模型上下文协议）服务器，为 [二维码生成器](https://qr-maker.io) 提供服务——生成样式化的二维码，管理动态短链接并提供点击分析功能，以及从任何 AI 助手发布微型登陆页面。
## 快速开始
### Claude 代码
将以下内容添加到 `~/.claude/claude_code_config.json`：
```json
{
"mcpServers": {
"qr-maker": {
"command": "npx",
"args": [
"@qr-maker/mcp-server",
"--api-key=qk_live_YOUR_API_KEY"
]
}
}
}
```
重启 Claude Code 并输入 `/mcp` 以验证。
### Cursor / Windsurf
将以下内容添加到 `.cursor/mcp.json`：
```json
{
"mcpServers": {
"qr-maker": {
"command": "npx",
"args": ["@qr-maker/mcp-server", "--api-key=qk_live_YOUR_API_KEY"]
}
}
}
```
### 环境变量
除了 `--api-key` 之外，您还可以设置：
```bash
export QR_MAKER_API_KEY=qk_live_YOUR_API_KEY
export QR_MAKER_API_URL=https://api.qr-maker.io # 默认值
```
## 获取您的 API 密钥
1. 在 [qr-maker.io](https://qr-maker.io) 注册账户
2. 进入 **设置 → API 密钥**
3. 点击 **创建密钥** 并复制它
## 可用工具（19）
### 二维码生成
| 工具 | 描述 |
|------|-------------|
| `generate_qr` | 生成具有自定义颜色、圆点、徽标和边框的样式化二维码 |
| `batch_generate` | 批量生成最多 100 个二维码（Pro+） |
| `get_batch_status` | 查询批量作业状态 |
### 短链接
| 工具 | 描述 |
|------|-------------|
| `create_short_link` | 创建具有点击分析功能的受跟踪短链接 |
| `list_links` | 列出具有点击次数的短链接 |
| `get_link` | 获取特定短链接的详细信息 |
| `update_link` | 更新目标 URL、状态或过期时间 |
| `delete_link` | 永久删除短链接 |
| `get_link_analytics` | 点击分析 - 国家、设备、每日明细 |
### 样式预设
| 工具 | 描述 |
|------|-------------|
| `create_template` | 保存可重用的二维码样式预设 |
| `list_templates` | 列出已保存的样式预设 |
| `update_template` | 更新样式预设 |
| `delete_template` | 删除样式预设 |
| `render_template` | 使用已保存的样式预设生成二维码 |
### 登陆页面
| 工具 | 描述 |
|------|-------------|
| `publish_landing` | 发布 HTML 登陆页面 + 短链接 + 二维码，一步到位 |
| `get_landing` | 获取登陆页面详细信息 |
| `update_landing` | 更新登陆页面 HTML 并重新发布 |
### 账户
| 工具 | 描述 |
|------|-------------|
| `get_usage` | 查看当前配额和使用情况 |
| `get_capabilities` | 您所在计划的功能矩阵 |
## 示例提示
连接后，尝试：
- "为我的网站生成一个带有紫色圆点的二维码"
- "为 https://qr-maker.io 创建一个短链接并显示分析数据"
- "发布一个带有菜单和 WhatsApp 按钮的登陆页面，用于我的餐厅"
- "列出我的样式预设并使用新内容渲染一个"
## 使用 MCP Inspector 进行测试
```bash
npx @modelcontextprotocol/inspector \
npx @qr-maker/mcp-server -- \
--api-key=qk_live_YOUR_KEY
```
## 文档
- [快速入门](https://qr-maker.io/docs/quickstart)
- [API 参考](https://qr-maker.io/docs/api)
- [MCP 服务器指南](https://qr-maker.io/docs/agents)
- [ChatGPT 集成](https://qr-maker.io/docs/chatgpt)
- [OpenAPI 规范](https://api.qr-maker.io/v2/openapi.json)
## 许可证
MIT
