Content
# MCP Dev Tools
Ferramentas úteis para desenvolvedores via MCP - Arquitetura modular e extensível
## Pré-requisitos
- **Node.js 20+** - Versão mínima necessária para execução
- **Visibilidade Global** - Para IDEs da JetBrains, certifique-se que Node.js, npm e npx estejam disponíveis globalmente:
- `/usr/local/bin/node`
- `/usr/local/bin/npm`
- `/usr/local/bin/npx`
## Configuração
Para usar com assistentes de IA em IDEs como **Cursor**, **VS Code**, **Augment Code**, **Claude Desktop** e outros que suportam MCP.
### Configuração Padrão
Adicione no arquivo de configuração MCP da sua IDE:
```json
{
"mcpServers": {
"dev-tools": {
"command": "npx",
"args": ["-y", "mcp-dev-tools@latest"]
}
}
}
```
### Windows com WSL
Para usuários do Windows com WSL, a configuração pode precisar ser:
```json
{
"mcpServers": {
"dev-utils": {
"command": "wsl",
"args": ["npx", "-y", "mcp-dev-utils"]
}
}
}
```
## Ferramentas
### 🆔 **UUID** - Identificadores únicos
- `"Gere UUID v4"`
- `"Crie 5 UUIDs para IDs únicos"`
- `"UUID versão 1 com timestamp"`
### 📧 **Email** - Validação, geração e análise
- `"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** - Criptografia e integridade
- `"Hash SHA256 da senha 'password'"`
- `"MD5 do arquivo dados.txt"`
- `"SHA1 para verificação de integridade"`
### 📝 **JSON** - Utilitários completos para manipulação
- `"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"`
### 🎂 **Idade** - Cálculos temporais
- `"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 brasileiros
- `"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 brasileiras
- `"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"`
### 🔒 **Senhas** - Segurança e análise
- `"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"`
### 💳 **Cartões** - Pagamentos e testes
- `"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"`
### 📅 **Datas** - Timestamps e operações temporais
- `"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"`
### 📊 **Competências** - Períodos contábeis/fiscais (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** - Codificação e decodificação de dados
- `"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"`
### 📱 **QR Code** - Geração 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** - Manipulação 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: <tag> & 'texto'"`
- `"Compare dois XMLs e identifique diferenças estruturais"`
- `"Gere schema XSD básico a partir da estrutura XML"`
## Workflows Completos
### 👤 **Perfil de Usuário**
```
"Crie perfil: gere UUID para ID, valide email admin@test.com, hash da senha 'pass123', calcule idade para 15/03/1990, formate em JSON"
```
### 🏢 **Cadastro Empresarial**
```
"Cadastro empresa: gere CNPJ válido, valide email contato@empresa.com, crie UUID, hash da senha administrativa, formate dados em JSON"
```
### 🇧🇷 **Sistema Brasileiro**
```
"Sistema nacional: gere 3 CPFs, 2 CNPJs, valide emails gov.br, calcule idades para 01/01/1980 e 15/06/1995"
```
### 🔐 **Segurança e Autenticação**
```
"Setup segurança: gere senha forte, analise força, crie hash SHA256, gere UUID para sessão, verifique vazamentos"
```
### 📊 **Processamento de Dados**
```
"Processe dados: extraia emails do texto, valide CPFs encontrados, formate em JSON, gere UUIDs para registros"
```
### 🧪 **Ambiente de Testes**
```
"Dados teste: gere 5 CPFs, 3 CNPJs, 10 emails aleatórios, senhas variadas, cartões de teste, UUIDs únicos"
```
### 📄 **Processamento 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"
```
### 🔐 **Codificação de Dados**
```
"Codifique dados: converta 'dados confidenciais' para Base64, valide resultado, analise eficiência, decodifique para verificação, formate com quebras de linha"
```
### 🎯 **EXEMPLO COMPLETO - Todas as Ferramentas**
**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 (estruturado pela ferramenta JSON):**
```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"
}
}
```
✅ **Demonstração prática:** Todas as 14 ferramentas trabalhando em conjunto!
## Casos de Uso
**Desenvolvimento 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"
```
**Testes Automatizados:**
```
"Dados para testes: 5 CPFs válidos, 3 emails de teste, senhas variadas (forte, fraca, média), UUIDs para identificadores, estruture tudo em JSON"
```
**Processamento de JSON:**
```
"Analise JSON complexo: extraia emails com JSONPath, valide estrutura, compare versões, gere schema automático, minifique para produção"
```
**E-commerce/Pagamentos:**
```
"Sistema de pagamento: gere cartões de teste para Visa, Mastercard e Amex, valide números existentes, identifique bandeiras"
```
**Migração de Dados:**
```
"Processe migração: extraia emails de texto, gere novos UUIDs, valide CPFs existentes, formate em JSON"
```
**Sistemas Contábeis:**
```
"Gere competências 2024, valide formatos MM/YY, calcule vencimentos fiscais, analise períodos de apuração"
```
## Documentação
- 📖 **[Desenvolvimento](docs/DEVELOPMENT.md)** - Setup, arquitetura, testes e debugging
- 🤝 **[Contribuição](docs/CONTRIBUTING.md)** - Como contribuir, publicação e padrões
## Contribuição
Contribuições são bem-vindas! Veja o [guia de contribuição](docs/CONTRIBUTING.md) para:
- Configuração do ambiente de desenvolvimento
- Padrões de código e testes
- Processo de submissão de PRs
- Como adicionar novas ferramentas
**Requisitos:** Node.js 20+
## Licença
MIT
