Enhanced QR Code MCP Server

Generates QR codes with metadata, batch processing, and file management tools.

An advancedModel Context Protocol (MCP) serverthat generates QR codes andautomatically saves them as PNG fileswith comprehensive metadata, batch processing capabilities, and file management tools.

🔗 Dual Implementation Strategy
ThisPython implementationfocuses onreliable file generation and batch processing.
Foradvanced styling, analysis, and templates, see ourTypeScript implementation.

Built upon and enhanced from:@jwalsh/mcp-server-qrcode

git clone https://github.com/myownipgit/enhanced-qrcode-mcp.git cd enhanced-qrcode-mcp chmod +x setup.sh ./setup.sh

# Create virtual environment python3 -m venv venv source venv/bin/activate # Install dependencies pip install -r requirements.txt # Make server executable chmod +x src/enhanced_qrcode_server.py

{ "mcpServers": { "enhanced-qrcode": { "command": "python3", "args": ["/path/to/enhanced-qrcode-mcp/src/enhanced_qrcode_server.py"], "env": {}, "description": "Enhanced QR code generator with automatic PNG file saving" } } }

Generate a single QR code and automatically save as PNG file.

- content(required): Text content to encode
- output_directory: Target directory (default:./qr_output/)
- filename: Custom filename (auto-generated if empty)
- errorCorrectionLevel: L, M, Q, or H (default: M)
- size: Size multiplier 1-20 (default: 5)
- border: Border size 1-20 (default: 4)
- include_metadata: Generate JSON metadata (default: true)
- display_in_chat: Show in chat interface (default: true)

{ "content": "https://github.com/myownipgit/enhanced-qrcode-mcp", "output_directory": "./qr_codes/", "filename": "github_repo", "errorCorrectionLevel": "H", "size": 6 }

- PNG file:github_repo.png
- Metadata:github_repo_metadata.json
- Chat display (optional)

Generate multiple QR codes from array input.

{ "qr_codes": [ { "id": "contact", "content": "BEGIN:VCARD\nVERSION:3.0\nFN:John Doe\nORG:Acme Corp\nTEL:555-0123\nEMAIL:john@acme.com\nEND:VCARD", "type": "vcard" }, { "id": "website", "content": "https://example.com", "type": "url" } ], "output_directory": "./batch_output/", "size": 5 }

- PNG files:qr_contact.png,qr_website.png
- Individual metadata files
- Batch manifest:batch_manifest_YYYYMMDD_HHMMSS.json

List all QR code files in a directory with metadata.

{ "directory": "./qr_output/" }

output_directory/ ├── qr_20250616_143022_hello_world.png ├── qr_20250616_143022_hello_world_metadata.json ├── github_repo.png ├── github_repo_metadata.json └── batch_manifest_20250616_143500.json

{ "generated_date": "2025-06-16T14:30:22.123456", "content": "Hello World!", "parameters": { "error_correction": "M", "size": 5, "border": 4, "box_size": 10 }, "png_file": "/path/to/qr_file.png", "file_size_bytes": 1117 }

- Event Management: Generate ticket QR codes as ready-to-print PNG files
- Marketing: Create campaign QR codes with tracking metadata
- Inventory: Generate asset labels with automatic file organization
- Contact Sharing: Batch create vCard QR codes for business cards

- Print Production: Direct PNG output for design workflows
- API Workflows: Batch generate QR codes from database records
- Asset Management: Organized file structure with metadata
- Quality Control: Error correction levels for different environments

# Activate virtual environment source venv/bin/activate # Run tests python3 tests/test_server.py

🚀 Running Enhanced QR Code MCP Server Tests ✅ QR code generation successful ✅ Filename generation tests passed ✅ File operations tests passed ✅ Integration test passed - 3 files generated 📊 Test Results: 4/4 passed 🎉 All tests passed! Enhanced MCP server is ready to use.

- Single QR code: ~50ms generation + file save
- Batch processing: ~100ms per code + manifest
- Metadata generation: ~5ms per file
- File listing: ~10ms per 100 files

- L (Low): ~7% damage recovery - basic indoor use
- M (Medium): ~15% damage recovery - standard use (default)
- Q (Quartile): ~25% damage recovery - industrial environments
- H (High): ~30% damage recovery - outdoor/damaged surfaces

See our comprehensiveROADMAP.mdfor detailed development plans including:

OurTypeScript implementationalready includes:

# Test dependencies python3 -c "import qrcode, mcp; print('✅ Dependencies OK')" # Test server startup python3 src/enhanced_qrcode_server.py

Contributions are welcome! Please seeCONTRIBUTING.mdfor guidelines.

git clone https://github.com/myownipgit/enhanced-qrcode-mcp.git cd enhanced-qrcode-mcp ./setup.sh source venv/bin/activate python3 tests/test_server.py

MIT License - seeLICENSEfile for details.

- Original Work:@jwalsh/mcp-server-qrcode- Foundation QR code MCP server
- MCP Protocol:Model Context Protocol- Enabling AI-tool integration
- QR Code Library:qrcode- Core QR code generation
- Pillow:PIL/Pillow- Image processing capabilities

- Enhanced TypeScript Version- Advanced styling and analysis features
- Original MCP QR Code Server- The foundation this builds upon
- Model Context Protocol- MCP specification and tools
- Claude Desktop- AI assistant with MCP support

Built with ❤️ upon the excellent foundation of@jwalsh/mcp-server-qrcode

An MCP server that integrates with Ollama to provide tools for file operations, calculations, and text processing. Requires a running Ollama instance.