Servidor MCP para gerar códigos QR personalizados diretamente no Cursor e Claude

Se você usa o Cursor, Claude Desktop ou Cline como seu editor diário, sabe como é irritante sair do seu editor apenas para gerar ativos simples de projeto.

Na semana passada, eu estava testando layouts de impressão para um projeto de marketing físico que precisava de códigos escaneáveis. Eu estava cansado de abrir abas do navegador, lutando contra geradores online spams que bloqueiam downloads de vetores atrás de paywalls, ou sendo forçado a uma assinatura apenas para obter um SVG.

Então, eu construí um servidor MCP (Modelo de Protocolo de Contexto) para meu Gerador de QR.

Agora, meu assistente de IA pode gerar códigos QR personalizados de alta resolução (incluindo vetores limpos, formas personalizadas e logotipos incorporados) diretamente dentro do meu IDE.

Aqui está como funciona, o que ele faz e como conectá-lo ao seu ambiente.

O que ele faz (e por que PNGs padrão são ruins)

A maioria dos geradores de QR básicos produz PNGs de baixa resolução. Se você tentar imprimi-los em embalagens ou sinalizações, eles pixelizam e escaneiam terrivelmente sob iluminação ruim.

Para resolver isso, o servidor MCP expõe uma única ferramenta altamente flexível: generate_qr_code. Ele permite que você controle:

• Formato: Escolha entre png padrão, svg (perfeito para impressão) ou json bruto.
• Física do Design: Estilos de pontos personalizados como círculo, hex (hexágono) e diamante em vez de quadrados antigos e chatos.
• Cor & Branding: Mapeamento direto de cores hexadecimais primárias (por exemplo, #00f0ff) e uploads de logotipos personalizados dentro da grade de dados.

Configurando no seu IDE

Como o servidor funciona sobre Eventos Enviados pelo Servidor (SSE) hospedados em nosso backend na nuvem, você não precisa instalar tempos de execução locais ou configurar ambientes Python/Node.

Para adicioná-lo à sua configuração do Claude Desktop ou Cursor, abra seu claude_desktop_config.json (ou suas configurações do MCP do Cursor) e cole este trecho:

{
  "mcpServers": {
    "ez-qr-generator": {
      "url": "https://ez-qr-generator.com/mcp",
      "transport": "sse"
    }
  }
}

Uma vez salvo, seu agente de IA detectará automaticamente a conexão.

Como usá-lo na prática

Você não precisa escrever nenhum argumento JSON manualmente. Basta dizer ao seu assistente o que você quer em inglês simples. Por exemplo, se você estiver trabalhando no Cursor, pode solicitar ao seu agente:

"Ei, gere um código QR hexagonal verde apontando para https://ez-qr-generator.com e coloque-o na minha pasta de ativos como um SVG."

O assistente chama o servidor, processa a saída em base64 ou SVG e escreve o arquivo diretamente no seu espaço de trabalho. Sem troca de contexto, sem inscrições e sem paywalls.

Se você quiser testar o endpoint JSON-RPC bruto você mesmo ou ver o registro oficial, pode conferir a página do Smithery.

Dê uma chance e me avise se você encontrar algum problema de esquema ou conexão!