Amzqr

MCP server that wraps amazing-qr and exposes QR-code generation as a Model Context Protocol (MCP) tool for any MCP client.

CI PyPI version Python versions

Capabilities

• generate — Generates a QR-code image file from text (a URL or sentence), with the full amazing-qr feature set: QR version, error-correction level, embedded picture, colorized output, contrast/brightness tuning, and custom output file name and directory. Returns the QR version, level, and output filepath. For the parameter reference and usage examples, see the amazing-qr project.
• data://info — Read-only resource returning the server and amzqr versions as JSON.

Quick start

Configure or register the server in your MCP client. Here are examples for common agents.

Desktop agents

Claude Desktop — add the server to claude_desktop_config.json:

{
  "mcpServers": {
    "amazing-qr": {
      "command": "uvx",
      "args": ["amzqr-mcp"]
    }
  }
}

Cursor — create .cursor/mcp.json in your project (or ~/.cursor/mcp.json for all projects) and add config above.

CLI agents

Prefer the agent's own command over editing config files by hand.

Codex:

codex mcp add amazing-qr -- uvx amzqr-mcp

Claude Code:

claude mcp add amazing-qr -- uvx amzqr-mcp

Run codex mcp list or claude mcp list to verify the server is connected.

Then ask your MCP client to generate a QR code. The generate tool writes an image file (default qrcode.png) and reports its path.