TradesMCP: Servidor MCP de Código Aberto para Verificação de Licença de Contratante e Dados de Construção

O que o TradesMCP faz

TradesMCP é um servidor Model Context Protocol construído com Claude Code que dá ao Claude acesso a dados reais de licenças de contratantes, autorizações de construção, preços de materiais e taxas de mão de obra. Nos testes, ele verificou corretamente uma licença ativa de contratante na Califórnia (1098765), enquanto o ChatGPT afirmou incorretamente que a licença "NÃO existe no sistema CSLB" e estava "não ativa (e provavelmente inválida)".

Comparação dos Resultados dos Testes

• Claude Code sem MCP: Não conseguiu enviar o formulário CSLB, disse ao usuário para verificar manualmente em cslb.ca.gov
• ChatGPT: Disse que a licença "NÃO existe no sistema CSLB" e estava "não ativa (e provavelmente inválida)" - incorreto para uma licença real e ativa
• Claude Code + TradesMCP: Uma chamada de ferramenta retornou resultado instantâneo: Carlos J Martinez, Martinez & Sons General Contracting Inc, B - Contratante Geral de Construção, Ativa, expira em 2027, fiança de US$ 25K, seguro de trabalhadores arquivado

Recursos e Cobertura

TradesMCP inclui 13 ferramentas cobrindo:

• Verificação de licença de contratante em CA, TX, FL, NY (bancos de dados governamentais reais, não dados de treinamento)
• Busca de autorização de construção com histórico de inspeções
• Preços de materiais para 20+ itens
• Taxas de mão de obra BLS para 12 ofícios em 12 áreas metropolitanas
• Estimativa de custo de projeto com ajustes regionais
• Acompanhamento de conformidade — seguros, fianças, prazos de renovação

Todos os 4 estados acessam fontes de dados reais em tempo real: raspagem do CSLB da Califórnia, API Socrata do Texas (958K+ registros), DBPR da Flórida, NYC Open Data + DOB BIS.

Instalação e Configuração

Instale via pip:

pip install git+https://github.com/Mahender22/trades-mcp.git

Para Claude Code:

claude mcp add trades-mcp -e TRADES_MCP_DEMO=true -- trades-mcp

Para Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "trades-mcp": {
      "command": "/path/to/trades-mcp-env/bin/trades-mcp",
      "env": {
        "TRADES_MCP_DEMO": "true"
      }
    }
  }
}

Detalhes do Projeto

Grátis, código aberto, licença MIT. 68 testes. Construído inteiramente com Claude Code. Disponível no GitHub: https://github.com/Mahender22/trades-mcp