Enhanced QR Code MCP Server

Pembuatan dan pemrosesan kode QR tingkat lanjut dengan dukungan untuk gaya kustom, berbagai format, pemrosesan batch, dan analitik.

GitHub

Dokumentasi

Enhanced QR Code MCP Server

An enhanced Model Context Protocol (MCP) server for advanced QR code generation and processing, inspired by and extending @jwalsh/mcp-server-qrcode.

🙏 Attribution

This project builds upon the excellent foundation provided by @jwalsh/mcp-server-qrcode. We extend our gratitude to the original author for creating the base QR code MCP server that inspired these enhancements.

✨ Enhanced Features

Beyond the original QR code generation capabilities, this enhanced version adds:

🚀 Advanced QR Code Generation

  • Custom styling: Logo embedding, custom colors, rounded corners
  • Multiple formats: PNG, SVG, PDF output support
  • Batch processing: Generate multiple QR codes simultaneously
  • Template system: Pre-defined QR code templates for common use cases

📊 Smart Content Detection

  • URL validation: Automatically validates and optimizes URLs
  • Contact cards: Generate vCard QR codes from contact information
  • WiFi credentials: Create WiFi network QR codes
  • Event details: Generate calendar event QR codes

🔍 QR Code Analysis

  • Decode existing QR codes: Extract content from QR code images
  • Quality assessment: Analyze QR code readability and optimization
  • Format detection: Identify QR code content types

📈 Analytics & Tracking

  • Usage statistics: Track QR code generation patterns
  • Performance metrics: Monitor server performance and response times
  • Export capabilities: Generate reports and analytics

🛠 Installation

# Clone the repository
git clone https://github.com/myownipgit/mcp-server-qrcode-enhanced.git
cd mcp-server-qrcode-enhanced

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

🔧 Configuration

Add to your MCP client configuration:

{
  "mcpServers": {
    "qrcode-enhanced": {
      "command": "node",
      "args": ["path/to/mcp-server-qrcode-enhanced/dist/index.js"],
      "env": {
        "QR_OUTPUT_DIR": "./qr-codes",
        "QR_DEFAULT_SIZE": "300",
        "QR_DEFAULT_ERROR_CORRECTION": "M"
      }
    }
  }
}

📋 Available Tools

Basic QR Code Generation

  • generate_qr_basic - Simple QR code generation
  • generate_qr_styled - QR code with custom styling
  • generate_qr_batch - Generate multiple QR codes

Specialized QR Codes

  • generate_vcard_qr - Contact card QR codes
  • generate_wifi_qr - WiFi network QR codes
  • generate_event_qr - Calendar event QR codes

Analysis & Processing

  • decode_qr_image - Extract content from QR code images
  • analyze_qr_quality - Assess QR code quality
  • optimize_qr_content - Optimize content for QR codes

Templates & Utilities

  • list_qr_templates - Available QR code templates
  • get_qr_statistics - Usage and performance statistics
  • validate_qr_content - Validate content before generation

📖 Usage Examples

Generate a styled QR code

const result = await generateStyledQR({
  content: "https://example.com",
  style: {
    foregroundColor: "#000000",
    backgroundColor: "#ffffff",
    logoPath: "./logo.png",
    cornerRadius: 10
  },
  format: "png",
  size: 400
});

Create a WiFi QR code

const wifiQR = await generateWiFiQR({
  ssid: "MyNetwork",
  password: "MyPassword",
  security: "WPA2",
  hidden: false
});

Decode an existing QR code

const decoded = await decodeQRImage({
  imagePath: "./qr-code.png",
  outputFormat: "json"
});

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. Make sure to:

  1. Follow the existing code style
  2. Add tests for new features
  3. Update documentation as needed
  4. Reference the original @jwalsh/mcp-server-qrcode when appropriate

📄 License

MIT License - see LICENSE file for details.

🔗 Related Projects

📝 Changelog

v1.0.0

  • Initial enhanced version based on @jwalsh/mcp-server-qrcode
  • Added custom styling capabilities
  • Implemented specialized QR code types
  • Added QR code analysis tools
  • Enhanced error handling and validation

Built with ❤️ on top of the excellent foundation by @jwalsh