MCP Dev Utils

Un servidor MCP modular y extensible con utilidades esenciales para desarrolladores.

Documentación

MCP Dev Utils

Herramientas útiles para desarrolladores vía MCP - Arquitectura modular y extensible

Requisitos previos

  • Node.js 20+ - Versión mínima necesaria para ejecución
  • Visibilidad Global - Para IDEs de JetBrains, asegúrese de que Node.js, npm y npx estén disponibles globalmente:
    • /usr/local/bin/node
    • /usr/local/bin/npm
    • /usr/local/bin/npx

Configuración

Para usar con asistentes de IA en IDEs como Cursor, VS Code, Augment Code, Claude Desktop y otros que soporten MCP.

Configuración Estándar

Agregue en el archivo de configuración MCP de su IDE:

{
  "mcpServers": {
    "dev-tools": {
      "command": "npx",
      "args": ["-y", "mcp-dev-tools@latest"]
    }
  }
}

Windows con WSL

Para usuarios de Windows con WSL, la configuración puede necesitar ser:

{
  "mcpServers": {
    "dev-utils": {
      "command": "wsl",
      "args": ["npx", "-y", "mcp-dev-utils"]
    }
  }
}

Herramientas

🆔 UUID - Identificadores únicos

  • "Gere UUID v4"
  • "Crie 5 UUIDs para IDs únicos"
  • "UUID versão 1 com timestamp"

📧 Email - Validación, generación y análisis

  • "Valide email admin@empresa.com"
  • "Gere 3 emails profissionais"
  • "Extraia emails do texto: Contatos: admin@test.com, suporte@site.org"
  • "Analise email temporario@10minutemail.com"
  • "Formate emails: ADMIN@TEST.COM, user@SITE.ORG"

🔐 Hash - Criptografía e integridad

  • "Hash SHA256 da senha 'password'"
  • "MD5 do arquivo dados.txt"
  • "SHA1 para verificação de integridade"

📝 JSON - Utilidades completas para manipulación

  • "Formate JSON: {'nome':'João','idade':30} com chaves ordenadas"
  • "Valide JSON e mostre estatísticas: [1,2,{'teste':true}]"
  • "Converta dados para JSON estruturado com template personalizado"
  • "Analise JSON com estatísticas: tipos, profundidade, propriedades"
  • "Extraia valores com JSONPath: empresa.funcionarios[0]"
  • "Compare dois JSONs e mostre diferenças"
  • "Gere schema JSON automaticamente"
  • "Minifique JSON e calcule redução de tamanho"

🎂 Edad - Cálculos temporales

  • "Calcule idade para nascimento em 1990-05-15"
  • "Idade de quem nasceu em 15/03/1992"
  • "Quantos anos tem quem nasceu em 25/12/1980"

🇧🇷 CPF - Documentos brasileños

  • "Gere CPF válido"
  • "Valide 123.456.789-09"
  • "Adicione máscara ao CPF 12345678909"
  • "Remova máscara de 123.456.789-09"
  • "Verifique CPFs: 11111111111, 123.456.789-09"

🏢 CNPJ - Empresas brasileñas

  • "Gere CNPJ válido"
  • "Valide 11.222.333/0001-81"
  • "Adicione máscara ao CNPJ 11222333000181"
  • "Remova máscara do CNPJ 11.222.333/0001-81"
  • "Crie 3 CNPJs para testes"

🔒 Contraseñas - Seguridad y análisis

  • "Gere senha forte"
  • "Analise força de 'MinhaSenh@123'"
  • "Crie frase-senha memorável"
  • "Gere 3 senhas médias"
  • "Senha numérica de 6 dígitos"
  • "Verifique se senha 'password123' foi vazada"

💳 Tarjetas - Pagos y pruebas

  • "Gere cartão Visa com CVV"
  • "Valide 4111111111111111"
  • "Identifique bandeira do cartão 4532123456789012"
  • "Gere 3 cartões mistos com datas vencidas"
  • "Analise cartão completo: 4111111111111111"
  • "Formate cartões com máscara: 4111111111111111"

📅 Fechas - Timestamps y operaciones temporales

  • "Gere timestamp atual com milissegundos"
  • "Gere 5 datas aleatórias em 2024"
  • "Valide datas: 2024-01-15, 15/01/2024, 01/15/2024"
  • "Converta 2024-01-15 para formato brasileiro"
  • "Calcule diferença entre 2024-01-01 e 2024-12-31 em dias"
  • "Calcule idade para nascimento em 1990-05-15"
  • "Adicione 30 dias úteis a 2024-01-15"
  • "Formate 2024-01-15 por extenso em português"
  • "Analise informações completas de 2024-01-15"
  • "Gere próximos 10 dias úteis a partir de hoje"

📊 Competencias - Períodos contables/fiscales (MM/YYYY, MM/YY, YY-MM)

  • "Gere últimos 12 meses de competências"
  • "Valide competências: 01/2024, 02/24, 24-03, 13/24"
  • "Converta 01/24 para formato MM/YYYY"
  • "Calcule diferença entre 01/2024 e 12/2024"
  • "Adicione 6 meses à competência 03/2024"
  • "Formate 01/2024 por extenso: Janeiro de 2024"
  • "Gere sequência de 01/2024 até 06/2024"
  • "Converta 03/2024 para primeiro e último dia do mês"

🔐 Base64 - Codificación y decodificación de datos

  • "Codifique texto: Olá mundo! para Base64"
  • "Decodifique Base64: SGVsbG8gV29ybGQh para texto"
  • "Codifique múltiplos textos: Hello, World, Test"
  • "Decodifique múltiplos Base64 com estatísticas"
  • "Codifique para Base64 URL-safe: dados+especiais/teste="
  • "Decodifique Base64 URL-safe: SGVsbG8tV29ybGQ"
  • "Valide strings Base64: SGVsbG8=, invalid!@#, dGVzdA=="
  • "Analise eficiência de codificação Base64"
  • "Formate Base64 com quebras de linha (76 caracteres)"
  • "Detecte tipo de Base64: padrão, URL-safe ou inválido"

📱 Código QR - Generación de códigos QR

  • "Gere QR Code para URL: https://github.com/afialho/mcp-dev-tools"
  • "Crie QR Code para email: contato@empresa.com"
  • "Gere QR Code para telefone: +5511999999999"
  • "Crie QR Code para WiFi: MinhaRede,MinhaSenh@123,WPA2"
  • "Gere QR Code vCard: João Silva,+5511999999999,joao@example.com"
  • "Crie QR Code em formato PNG Base64 para texto: Olá mundo"
  • "Gere QR Code SVG com correção de erro alta para: Dados importantes"

📄 XML - Manipulación completa de documentos XML

  • "Formate XML: <root><pessoa nome='João'><idade>30</idade></pessoa></root>"
  • "Minifique XML e calcule redução de tamanho"
  • "Valide sintaxe XML e analise estrutura"
  • "Converta XML para JSON preservando atributos"
  • "Converta JSON para XML com elemento raiz personalizado"
  • "Extraia valores com XPath: //pessoa/@nome, //idade"
  • "Analise estrutura XML: elementos, atributos, profundidade, namespaces"
  • "Escape caracteres especiais: <tag> & 'texto' para XML"
  • "Desescape entidades XML: &lt;tag&gt; &amp; &apos;texto&apos;"
  • "Compare dois XMLs e identifique diferenças estruturais"
  • "Gere schema XSD básico a partir da estrutura XML"

Flujos de Trabajo Completos

👤 Perfil de Usuario

"Crie perfil: gere UUID para ID, valide email admin@test.com, hash da senha 'pass123', calcule idade para 15/03/1990, formate em JSON"

🏢 Registro Empresarial

"Cadastro empresa: gere CNPJ válido, valide email contato@empresa.com, crie UUID, hash da senha administrativa, formate dados em JSON"

🇧🇷 Sistema Brasileño

"Sistema nacional: gere 3 CPFs, 2 CNPJs, valide emails gov.br, calcule idades para 01/01/1980 e 15/06/1995"

🔐 Seguridad y Autenticación

"Setup segurança: gere senha forte, analise força, crie hash SHA256, gere UUID para sessão, verifique vazamentos"

📊 Procesamiento de Datos

"Processe dados: extraia emails do texto, valide CPFs encontrados, formate em JSON, gere UUIDs para registros"

🧪 Entorno de Pruebas

"Dados teste: gere 5 CPFs, 3 CNPJs, 10 emails aleatórios, senhas variadas, cartões de teste, UUIDs únicos"

📄 Procesamiento XML

"Processe XML: valide estrutura do arquivo config.xml, extraia configurações com XPath //database/@host, converta para JSON, compare com backup.xml, gere schema XSD"

🔐 Codificación de Datos

"Codifique dados: converta 'dados confidenciais' para Base64, valide resultado, analise eficiência, decodifique para verificação, formate com quebras de linha"

🎯 EJEMPLO COMPLETO - Todas las Herramientas

Comando:

"Cadastro completo: gere UUID para ID da empresa, crie CNPJ válido para registro, gere CPF válido para representante legal, crie email de contato para empresa Tech XPTO, gere senha forte para acesso administrativo, analise força da senha criada, crie hash SHA256 da senha para armazenamento, calcule idade do representante nascido em 21/11/1980, gere timestamp atual para data de cadastro, gere competência para 3 meses à frente da competencia atual para período de ativação, gere cartão de crédito corporativo Mastercard com CVV e data futura, codifique a senha em Base64 para transmissão segura, converta todos estes dados para XML estruturado com elemento raiz 'empresa', gere QR Code com os dados da empresa e depois use a ferramenta JSON para converter o XML em formato JSON organizado por categorias"

Resultado esperado (estructurado por la herramienta JSON):

{
  "acesso": {
    "forca_senha": "Muito Forte - 98/100",
    "senha_hash": "a665a45920422f9d417e4867efdc4fb8a04a1f3fff1fa07e998e86f7f7a27ae3"
  },
  "empresa": {
    "cnpj": "12.345.678/0001-90",
    "email": "contato@techxpto.com.br",
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "nome": "Tech XPTO"
  },
  "financeiro": {
    "cartao_corporativo": {
      "bandeira": "Mastercard",
      "cvv": "123",
      "numero": "5555-4444-3333-2222",
      "validade": "12/29"
    }
  },
  "representante_legal": {
    "cpf": "123.456.789-09",
    "data_nascimento": "1980-11-21",
    "idade": 44,
    "nome": "Carlos Eduardo Silva"
  },
  "sistema": {
    "competencia_ativacao": "09/2025",
    "data_cadastro": "2025-06-26T10:30:00Z"
  }
}

✅ Demostración práctica: ¡Todas las 14 herramientas trabajando en conjunto!

Casos de Uso

Desarrollo de API:

"Para API de usuários: gere UUID para ID, valide email do payload, hash da senha com SHA256, estruture resposta em JSON organizado por categorias"

Pruebas Automatizadas:

"Dados para testes: 5 CPFs válidos, 3 emails de teste, senhas variadas (forte, fraca, média), UUIDs para identificadores, estruture tudo em JSON"

Procesamiento de JSON:

"Analise JSON complexo: extraia emails com JSONPath, valide estrutura, compare versões, gere schema automático, minifique para produção"

E-commerce/Pagos:

"Sistema de pagamento: gere cartões de teste para Visa, Mastercard e Amex, valide números existentes, identifique bandeiras"

Migración de Datos:

"Processe migração: extraia emails de texto, gere novos UUIDs, valide CPFs existentes, formate em JSON"

Sistemas Contables:

"Gere competências 2024, valide formatos MM/YY, calcule vencimentos fiscais, analise períodos de apuração"

Documentación

  • 📖 Desarrollo - Setup, arquitectura, pruebas y debugging
  • 🤝 Contribución - Cómo contribuir, publicación y estándares

Contribución

¡Las contribuciones son bienvenidas! Consulte la guía de contribución para:

  • Configuración del entorno de desarrollo
  • Estándares de código y pruebas
  • Proceso de envío de PRs
  • Cómo agregar nuevas herramientas

Requisitos: Node.js 20+

Licencia

MIT