Enhanced QR Code MCP Server

Generación y procesamiento avanzados de códigos QR con soporte para estilos personalizados, múltiples formatos, procesamiento por lotes y análisis.

GitHubPrueba este MCPPatrocinado

Documentación

Enhanced QR Code MCP Server

Un servidor mejorado del Protocolo de Contexto de Modelos (MCP) para la generación y procesamiento avanzado de códigos QR, inspirado en y extendiendo @jwalsh/mcp-server-qrcode.

🙏 Atribución

Este proyecto se basa en la excelente base proporcionada por @jwalsh/mcp-server-qrcode. Expresamos nuestro agradecimiento al autor original por crear el servidor MCP de códigos QR base que inspiró estas mejoras.

✨ Funciones Mejoradas

Más allá de las capacidades originales de generación de códigos QR, esta versión mejorada añade:

🚀 Generación Avanzada de Códigos QR

  • Estilos personalizados: Inserción de logotipos, colores personalizados, esquinas redondeadas
  • Múltiples formatos: Soporte de salida PNG, SVG, PDF
  • Procesamiento por lotes: Generar múltiples códigos QR simultáneamente
  • Sistema de plantillas: Plantillas de códigos QR predefinidas para casos de uso comunes

📊 Detección Inteligente de Contenido

  • Validación de URL: Valida y optimiza automáticamente las URL
  • Tarjetas de contacto: Genera códigos QR vCard a partir de información de contacto
  • Credenciales WiFi: Crea códigos QR para redes WiFi
  • Detalles de eventos: Genera códigos QR para eventos de calendario

🔍 Análisis de Códigos QR

  • Decodificar códigos QR existentes: Extrae contenido de imágenes de códigos QR
  • Evaluación de calidad: Analiza la legibilidad y optimización de los códigos QR
  • Detección de formato: Identifica los tipos de contenido de los códigos QR

📈 Analítica y Seguimiento

  • Estadísticas de uso: Realiza un seguimiento de los patrones de generación de códigos QR
  • Métricas de rendimiento: Supervisa el rendimiento del servidor y los tiempos de respuesta
  • Capacidades de exportación: Genera informes y analíticas

🛠 Instalación

# 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

🔧 Configuración

Añade a la configuración de tu cliente MCP:

{
  "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"
      }
    }
  }
}

📋 Herramientas Disponibles

Generación Básica de Códigos QR

  • generate_qr_basic - Generación simple de códigos QR
  • generate_qr_styled - Códigos QR con estilos personalizados
  • generate_qr_batch - Generar múltiples códigos QR

Códigos QR Especializados

  • generate_vcard_qr - Códigos QR de tarjetas de contacto
  • generate_wifi_qr - Códigos QR de redes WiFi
  • generate_event_qr - Códigos QR de eventos de calendario

Análisis y Procesamiento

  • decode_qr_image - Extraer contenido de imágenes de códigos QR
  • analyze_qr_quality - Evaluar la calidad de los códigos QR
  • optimize_qr_content - Optimizar contenido para códigos QR

Plantillas y Utilidades

  • list_qr_templates - Plantillas de códigos QR disponibles
  • get_qr_statistics - Estadísticas de uso y rendimiento
  • validate_qr_content - Validar contenido antes de la generación

📖 Ejemplos de Uso

Generar un código QR con estilo

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

Crear un código QR WiFi

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

Decodificar un código QR existente

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

🤝 Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una Solicitud de Extracción (Pull Request). Asegúrate de:

  1. Seguir el estilo de código existente
  2. Añadir pruebas para nuevas funciones
  3. Actualizar la documentación según sea necesario
  4. Referenciar el @jwalsh/mcp-server-qrcode original cuando corresponda

📄 Licencia

Licencia MIT - consulta el archivo LICENSE para más detalles.

🔗 Proyectos Relacionados

📝 Registro de Cambios

v1.0.0

  • Versión mejorada inicial basada en @jwalsh/mcp-server-qrcode
  • Añadidas capacidades de estilos personalizados
  • Implementados tipos de códigos QR especializados
  • Añadidas herramientas de análisis de códigos QR
  • Mejorado el manejo de errores y la validación

Construido con ❤️ sobre la excelente base de @jwalsh