Enhanced MCP QR Generator
About
A powerful and flexible MCP (Model Context Protocol) server for generating QR codes from URLs and text.
Explore
- QR Code Generation: Create QR codes from any text or URL
- Multiple Output Formats: Generate QR codes as PNG, SVG, base64, or terminal ASCII art
- Customization Options: Control size, margins, colors, and error correction levels
- Logo Integration: Add custom logos to the center of QR codes
- File Saving: Save generated QR codes to files with custom or auto-generated names
- MCP Integration: Full Model Context Protocol support for AI assistants
- Docker Support: Easy deployment with Docker and Docker Compose
- Health Monitoring: Built-in health check endpoint
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Enhanced MCP QR GeneratorCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
npm install enhanced-mcp-qr-generator
The server uses port 9999 by default. You can change this by:
1. Setting the PORT environment variable
2. When using Docker, updating the PORT environment variable in docker-compose.yml
3. When using Docker, updating the port mapping in docker-compose.yml
Example:
Configuration values are determined in the following order (highest priority first):
1. Command line arguments
2. Environment variables
3. Default values from config.ts
mkdir -p ~/.aws/amazonq
cat > ~/.aws/amazonq/mcp.json << EOF
{
"mcpServers": {
"qr-generator": {
"command": "npx",
"args": ["-y", "enhanced-mcp-qr-generator"]
}
}
}
EOF
You can also run the server using Docker:
{
"mcpServers": {
"qr-generator": {
"command": "docker",
"args": ["run", "-i", "--rm", "zavorai/enhanced-mcp-qr-generator"]
}
}
}
Generates a QR code from text or URL.
- text: Text or URL to encode in the QR code
- options: QR code generation options
- errorCorrectionLevel: Error correction level ('L', 'M', 'Q', 'H')
- format: Output format ('png', 'svg', 'base64', 'terminal')
- size: Size of QR code in pixels
- margin: Margin around the QR code in modules
- color: Color of the QR code (dark modules)
- backgroundColor: Background color of the QR code (light modules)
- logo: Logo options
- image: URL or base64 encoded image
- size: Size of the logo as a percentage of the QR code size
- config: Server configuration (optional)
Returns a QRCodeResult object:
- data: Generated QR code data
- mimeType: MIME type of the generated QR code
- format: Format of the generated QR code
- size: Size of the generated QR code in pixels
- content: Original text or URL encoded in the QR code
- timestamp: Timestamp when the QR code was generated
npm install
./docker-npm.sh ci
This runs npm commands in a Docker container with your user permissions, preventing any root-owned files.
- generate_qr: Generate a QR code from text or URL
- save_qr: Generate a QR code and save it to a file
The MCP server provides two tools:
1. generate_qr: Generates a QR code and returns it in the specified format
- Input: Text/URL, format options, styling options
- Output: QR code data with metadata
2. save_qr: Generates a QR code and saves it to a file
- Input: Text/URL, output path, format options, styling options
- Output: File path and metadata
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"enhanced mcp qr generator": {
"enhanced-mcp-qr-generator": {
"command": "npx",
"args": [
"enhanced-mcp-qr-generator"
],
"env": {
"PORT": "8080"
}
}
}
}
}McpServers
{
"enhanced-mcp-qr-generator": {
"command": "npx",
"args": [
"enhanced-mcp-qr-generator"
],
"env": {
"PORT": "8080"
}
}
}A powerful and flexible MCP (Model Context Protocol) server for generating QR codes from URLs and text.
Developed by James Karanja at Zavora AI.
Features
- QR Code Generation: Create QR codes from any text or URL
- Multiple Output Formats: Generate QR codes as PNG, SVG, base64, or terminal ASCII art
- Customization Options: Control size, margins, colors, and error correction levels
- Logo Integration: Add custom logos to the center of QR codes
- File Saving: Save generated QR codes to files with custom or auto-generated names
- MCP Integration: Full Model Context Protocol support for AI assistants
- Docker Support: Easy deployment with Docker and Docker Compose
- Health Monitoring: Built-in health check endpoint
Installation
npm install enhanced-mcp-qr-generator
Server Architecture
The Enhanced MCP QR Generator uses a single HTTP server that handles:
1. JSON-RPC Requests: For MCP protocol communication
2. Health Check Endpoint: Available at /health for monitoring
Port Configuration
The server uses port 9999 by default. You can change this by:
1. Setting the PORT environment variable
2. When using Docker, updating the PORT environment variable in docker-compose.yml
3. When using Docker, updating the port mapping in docker-compose.yml
Example:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
