Enhanced QR Code MCP Server

Geração e processamento avançados de QR code com suporte para estilização personalizada, múltiplos formatos, processamento em lote e análises.

GitHubExperimente este MCPPatrocinado

Documentação

Enhanced QR Code MCP Server

Um servidor aprimorado do Model Context Protocol (MCP) para geração e processamento avançado de QR codes, inspirado e estendendo @jwalsh/mcp-server-qrcode.

🙏 Atribuição

Este projeto se baseia na excelente fundação fornecida por @jwalsh/mcp-server-qrcode. Estendemos nossa gratidão ao autor original por criar o servidor MCP de QR code base que inspirou estas melhorias.

✨ Recursos Aprimorados

Além das capacidades originais de geração de QR code, esta versão aprimorada adiciona:

🚀 Geração Avançada de QR Code

  • Estilização personalizada: Incorporação de logotipo, cores personalizadas, cantos arredondados
  • Múltiplos formatos: Suporte a saída em PNG, SVG, PDF
  • Processamento em lote: Gere múltiplos QR codes simultaneamente
  • Sistema de modelos: Modelos de QR code pré-definidos para casos de uso comuns

📊 Detecção Inteligente de Conteúdo

  • Validação de URL: Valida e otimiza URLs automaticamente
  • Cartões de contato: Gere QR codes vCard a partir de informações de contato
  • Credenciais WiFi: Crie QR codes de redes WiFi
  • Detalhes de eventos: Gere QR codes de eventos de calendário

🔍 Análise de QR Code

  • Decodificar QR codes existentes: Extraia conteúdo de imagens de QR code
  • Avaliação de qualidade: Analise a legibilidade e otimização do QR code
  • Detecção de formato: Identifique tipos de conteúdo de QR code

📈 Análises e Rastreamento

  • Estatísticas de uso: Acompanhe padrões de geração de QR codes
  • Métricas de desempenho: Monitore o desempenho do servidor e tempos de resposta
  • Capacidades de exportação: Gere relatórios e análises

🛠 Instalação

# 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

🔧 Configuração

Adicione à configuração do seu 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"
      }
    }
  }
}

📋 Ferramentas Disponíveis

Geração Básica de QR Code

  • generate_qr_basic - Geração simples de QR code
  • generate_qr_styled - QR code com estilização personalizada
  • generate_qr_batch - Gere múltiplos QR codes

QR Codes Especializados

  • generate_vcard_qr - QR codes de cartões de contato
  • generate_wifi_qr - QR codes de redes WiFi
  • generate_event_qr - QR codes de eventos de calendário

Análise e Processamento

  • decode_qr_image - Extraia conteúdo de imagens de QR code
  • analyze_qr_quality - Avalie a qualidade do QR code
  • optimize_qr_content - Otimize conteúdo para QR codes

Modelos e Utilitários

  • list_qr_templates - Modelos de QR code disponíveis
  • get_qr_statistics - Estatísticas de uso e desempenho
  • validate_qr_content - Valide conteúdo antes da geração

📖 Exemplos de Uso

Gere um QR code estilizado

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

Crie um QR code WiFi

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

Decodifique um QR code existente

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

🤝 Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request. Certifique-se de:

  1. Seguir o estilo de código existente
  2. Adicionar testes para novos recursos
  3. Atualizar a documentação conforme necessário
  4. Referenciar o @jwalsh/mcp-server-qrcode original quando apropriado

📄 Licença

Licença MIT - consulte o arquivo LICENSE para detalhes.

🔗 Projetos Relacionados

📝 Registro de Alterações

v1.0.0

  • Versão aprimorada inicial baseada em @jwalsh/mcp-server-qrcode
  • Adicionadas capacidades de estilização personalizada
  • Implementados tipos especializados de QR code
  • Adicionadas ferramentas de análise de QR code
  • Tratamento de erros e validação aprimorados

Construído com ❤️ sobre a excelente fundação de @jwalsh