Enhanced MCP QR Generator

What is Enhanced MCP QR Generator?

It is an MCP (Model Context Protocol) server for generating QR codes from any text or URL. It supports multiple output formats (PNG, SVG, base64, terminal ASCII art), customization options (size, margins, colors, error correction levels), logo integration, and file saving. Designed for use with AI assistants, it also includes Docker support and a health monitoring endpoint. Developed by James Karanja at Zavora AI.

How to use Enhanced MCP QR Generator?

Install via npm (npm install enhanced-mcp-qr-generator) then run as an MCP server using npx enhanced-mcp-qr-generator. You can customize behavior with command line options (e.g., --error-correction-level=H, --format=svg, --size=500). For integration with AI assistants such as Amazon Q CLI or Claude Desktop, add an MCP configuration file (e.g., ~/.aws/amazonq/mcp.json) that references the server. The server uses port 9999 by default, which can be changed via the PORT environment variable.

Key features of Enhanced MCP QR Generator

• Generate QR codes from any text or URL
• Output formats: PNG, SVG, base64, terminal ASCII art
• Customizable size, margins, colors, and error correction (L, M, Q, H)
• Add a custom logo to the center of the QR code
• Save generated QR codes to files with auto-generated names
• Full MCP protocol support for AI assistants (JSON-RPC 2.0)
• Docker and Docker Compose deployment with health check endpoint

Use cases of Enhanced MCP QR Generator

• AI assistants generating QR codes for URLs provided during a conversation
• Integrating with Amazon Q CLI to create QR codes from chat commands
• Using Claude Desktop to produce QR codes with customized styling
• Programmatically generating QR codes in Node.js scripts with the generateQR API
• Saving QR codes to disk for sharing or printing

FAQ from Enhanced MCP QR Generator

What output formats are supported?

PNG, SVG, base64-encoded data, and terminal ASCII art.

Can I add a logo to a QR code?

Yes. You can specify a logo image (URL or base64) and its size as a percentage of the QR code size via the logo option in generateQR.

How do I run the server with Docker?

Use the MCP configuration: "command": "docker", "args": ["run", "-i", "--rm", "zavorai/enhanced-mcp-qr-generator"].

What error correction levels are available?

Levels L (low), M (medium), Q (quartile), and H (high) are supported, configurable via --error-correction-level or the defaultErrorCorrectionLevel config option.

Are there any size limits?

The maximum QR code size defaults to 2000 pixels (maxQRCodeSize), and the maximum logo file size is 2 MB (maxLogoSize). These can be overridden in the server configuration.