DevTools-BR MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
DevTools BR
API REST e servidor MCP com geradores, validadores, encoders e utilitários de texto inspirados no 4Devs.
O código de produção não chama o 4Devs. O projeto implementa os algoritmos localmente e usa o 4Devs apenas em testes de compatibilidade via browser, quando o oracle é ativado de forma explícita.
O que o projeto entrega
Geração e validação de documentos brasileiros: CPF, CNPJ, CNH, RG, PIS/PASEP e RENAVAM.
Consulta de CEP em base local: endereço por CEP, validação do número contra a faixa do complemento, estados e cidades por UF.
Encoders e decoders: Base64, MD5, SHA1 e URL encode/decode.
Ferramentas de texto: remover acentos, inverter texto e analisar contagens.
API REST v1 para uso por aplicações HTTP.
Servidor MCP v1 para uso por clientes compatíveis com Model Context Protocol.
Testes locais determinísticos e testes oracle opcionais contra o 4Devs via Playwright.
Related MCP server: MCP Dev Tools
Requisitos
Node.js 22.13 ou superior.
npm.
Docker e Docker Compose, se quiser rodar em containers.
Instalação
npm installREST
Inicie a API REST em desenvolvimento:
npm run dev:restPor padrão, a API escuta em http://127.0.0.1:3000.
Exemplo:
curl -s http://127.0.0.1:3000/api/generators/cpf \
-H 'content-type: application/json' \
-d '{"formatted":true,"state":"SP","seed":"demo"}'Resposta:
{
"cpf": "12345678909",
"formatted": "123.456.789-09",
"valid": true
}seed torna a geração determinística. Use esse campo em testes para obter sempre o mesmo resultado.
Endpoints REST
Todos os endpoints usam POST e recebem JSON.
Endpoint | Entrada | Saída |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
No v1, format: "alphanumeric" para CNPJ é rejeitado. A implementação atual gera CNPJ numérico.
Erros REST
Erros retornam um envelope estável:
{
"error": {
"code": "invalid_parameter",
"message": "Invalid request",
"field": "state"
}
}Códigos comuns:
invalid_parameter: payload inválido ou parâmetro fora do domínio aceito.invalid_input: entrada malformada, como Base64 inválido.internal_error: falha inesperada.cep_database_unavailable: base de CEP ausente ou inválida (gere comnpm run build:cep-db).
MCP
O projeto expõe as mesmas operações via MCP.
Para rodar via stdio:
npm run dev:mcp:stdioPara rodar via Streamable HTTP:
npm run dev:mcp:httpPor padrão, o endpoint HTTP escuta em:
http://127.0.0.1:3001/mcpFerramentas MCP disponíveis:
generate_cpf,validate_cpfgenerate_cnpj,validate_cnpjgenerate_cnh,validate_cnhgenerate_rg,validate_rggenerate_pis_pasep,validate_pis_pasepgenerate_renavam,validate_renavamencode_base64,decode_base64encode_md5,encode_sha1encode_url,decode_urlremove_text_accents,reverse_text,analyze_textlookup_cep,list_states,list_cities
Recursos MCP disponíveis:
devs-clone://catalog/toolsdevs-clone://schemas/rest-v1devs-clone://schemas/mcp-v1devs-clone://reference/statesdevs-clone://reference/algorithms
Base de CEP
A consulta de CEP usa uma base SQLite local gerada a partir dos CSVs versionados em data/ceps/, com dados do CEP Aberto. A base cobre 27 estados, 10.663 cidades e 1.137.150 CEPs. O banco (~118 MB) não é versionado; gere-o com:
npm run build:cep-dbOpções: --input (padrão data/ceps), --output (padrão <input>/ceps.sqlite) e --overwrite. Sem o banco, os endpoints de CEP respondem 503 com cep_database_unavailable; os demais endpoints funcionam normalmente. A variável CEP_DATABASE aponta um arquivo alternativo.
Sem number, a resposta traz numberValidation.status: "not_provided"; sem regra no complemento, "range_unavailable"; com regra, "compatible" ou "incompatible" (faixa e/ou lado par/ímpar).
Docker
Suba a API REST e o MCP HTTP com Docker Compose:
docker compose up --buildO Compose publica:
REST:
http://127.0.0.1:3000MCP HTTP:
http://127.0.0.1:3001/mcp
A imagem inclui o banco de CEP gerado no build (~118 MB adicionais). Os CSVs não vão para a imagem final.
Serviços:
rest: executanpm run start:rest.mcp-http: executanpm run start:mcp:http.
Build de produção
Compile o TypeScript:
npm run buildDepois rode os entrypoints compilados:
npm run start:rest
npm run start:mcp:httpVariáveis úteis:
HOST: host da API REST. Padrão:127.0.0.1.PORT: porta da API REST. Padrão:3000.MCP_HTTP_HOST: host do MCP HTTP. Padrão:HOSTou127.0.0.1.MCP_HTTP_PORT: porta do MCP HTTP. Padrão:3001.
Testes
Rode a suíte local:
npm run typecheck
npm run testRode grupos específicos:
npm run test:unit
npm run test:rest
npm run test:mcpOs testes oracle via browser ficam desativados por padrão:
npm run test:oraclePara comparar fluxos reais com o 4Devs, ative o oracle:
RUN_4DEVS_ORACLE=1 npm run test:oracleEsses testes dependem da rede e da interface atual do 4Devs. Use-os como referência de compatibilidade, não como dependência de produção.
Estrutura
src/domain Algoritmos e regras de domínio
src/schemas Schemas de entrada e saída
src/services Casos de uso v1
src/rest Servidor REST
src/mcp Servidor MCP
tests/domain Testes unitários de domínio
tests/rest Testes da API REST
tests/mcp Testes do MCP
tests/oracle Testes opcionais contra o 4Devs via browser
scripts Scripts de build (gerador do SQLite de CEPs)
data/ceps CSVs de CEP (CEP Aberto); o SQLite gerado fica fora do gitEscopo atual
O v1 cobre uma parte selecionada do 4Devs: documentos brasileiros, encoders, ferramentas de texto e consulta de CEP. O objetivo é expandir esse contrato aos poucos, mantendo entradas, saídas e testes claros antes de adicionar novas ferramentas.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Developer utilities MCP server: base64, hash, slug, uuid v4, timestamp, urlencode. Free, no key.
Remote MCP for JSON repair, hashing, formatting, IDs, dates, units, and other small tools.
Tiny devtools MCP server: slugs, timestamps, case conversion, hashing, base64, UUIDs.
500+ free tools over MCP: dev, text and security utilities, 230+ calculators. No sign-up.
Related MCP Servers
AlicenseAqualityCmaintenanceA privacy-first MCP server providing 14 offline Brazilian utilities including document validation, boleto parsing, PIX BR Code generation/parsing, and calendar tools.221MIT- AlicenseBqualityDmaintenanceProvides a comprehensive set of developer utilities including UUID generation, email validation, hashing, JSON manipulation, Brazilian document handling, and more, accessible via MCP.1524 npm2MIT
- AlicenseAqualityCmaintenanceMCP server for validating and generating Brazilian documents (CPF, CNPJ, and bank boletos) with 6 tools, a resource, and a prompt.6MIT
- AlicenseNot gradedqualityCmaintenanceMCP server for Brazilian data lookups (Pix codes, CEP, CNPJ) and web rendering tasks (Markdown, screenshots, PDFs) via a paid HTTP API with x402 billing.51 npm1MIT