Enhanced MCP QR Generator

Name: Enhanced MCP QR Generator
Author: zavora-ai

@zavora-ai

Repository

About Enhanced MCP QR Generator

A powerful and flexible MCP (Model Context Protocol) server for generating QR codes from URLs and text.

#qr-generator #mcp #url-encoder

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "enhanced-mcp-qr-generator": {
      "command": "npx",
      "args": [
        "enhanced-mcp-qr-generator"
      ],
      "env": {
        "PORT": "8080"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.