Construction MCP

Documentação

Servidor MCP de referência de construção

Um pequeno servidor Model Context Protocol offline que fornece a um assistente de IA dados de referência de construção e calculadoras que ele adivinharia de outra forma: códigos de custo, termos de construção, fatores de desperdício, unidades de pagamento, a sequência típica de ofícios, métricas de custo e cronograma, conversões de unidades e calculadoras para concreto, vergalhão, alvenaria, asfalto, terraplenagem, valor agregado, retenção e markup versus margem.

É uma árvore de arquivos Python com nenhuma dependência, nenhum acesso à rede e nenhuma conta. Os dados acompanham o servidor.

Ferramentas

Consultas de referência

Ferramenta	Pergunte coisas como	Retorna
`lookup_cost_code`	"Qual código de custo para laje sobre o solo?" "Liste a divisão 09"	Código, descrição, divisão CSI, tipo de custo, unidade, observações
`define_term`	"O que é retenção?" "O que significa AHJ?"	Definições de glossário de contrato, controle de custos, campo, segurança e finanças
`waste_factor`	"Qual desperdício devo considerar para azulejos?"	Percentual baixo e alto de planejamento, base e o que o influencia
`pay_unit`	"Como a escavação em massa é paga?"	Unidade de pagamento, base de medição e exclusões usuais
`trade_sequence`	"O que vem antes do drywall?"	Ofício, atividade, precedente, direcionador de duração e a restrição que geralmente afeta
`metric_formula`	"Como o TCPI é calculado?"	Fórmula, entradas, interpretação e ressalvas
`convert_units`	"Converter 2 M3 para CY" "450 PSF em KSF"	O resultado, o fator e as observações. Recusa conversões que precisam de mais informações, como LF para SF

Calculadoras

Ferramenta	Pergunte coisas como	Retorna
`concrete_volume`	"Laje de 40 por 30, 6 polegadas de espessura"	CF e CY exatos, e CY de pedido com um determinado desperdício ou a faixa de planejamento
`rebar_weight`	"100 barras #5 a 20 pés"	Libras e toneladas, com a faixa de desperdício
`masonry_units`	"1.000 SF de parede de CMU com 80 SF de aberturas"	Unidades exatas e com desperdício
`asphalt_tonnage`	"9.000 SF pavimentados a 3 polegadas"	Toneladas exatas e com desperdício
`earthwork_volume`	"1.000 jardas bancárias de argila: quanto transportar?"	Faixas de volume solto e compactado
`earned_value`	"BAC 1M, EV 400k, AC 450k, PV 500k"	CV, SV, CPI, SPI, dois EACs, ETC, VAC e TCPI, com avisos quando for cedo demais para confiar neles
`retainage`	"Retenção de 10% sobre 500k faturados, 380k já pagos"	Retenção retida e pendente, e o valor devido
`markup_margin`	"Custo 100.000 com markup de 20%: qual é minha margem?"	Preço, lucro, markup e margem

Toda ferramenta é somente leitura e informa ao modelo que seus resultados são valores de planejamento a serem verificados com seus próprios dados.

Recursos

Os oito conjuntos de dados por trás das ferramentas também são expostos como recursos MCP somente leitura (construction-reference://data/<name>.csv), para que um cliente possa anexar uma tabela inteira a uma conversa: códigos de custo, glossário, fatores de desperdício, fatores de terraplenagem, conversões de unidades, unidades de pagamento, sequência de ofícios e fórmulas de métricas. Somente esses arquivos incluídos podem ser lidos.

O que ele não faz

Sem rede. Ele nunca abre uma porta ou faz uma solicitação. Ele fala apenas com o aplicativo que o iniciou, por entrada e saída padrão.
Sem conexões. Ele não se conecta a nenhum sistema de contabilidade, gerenciamento de projetos ou cronograma, a nenhum produto ou servidor Constructelligence, nem a qualquer outra coisa.
Sem arquivos, sem memória. Ele lê apenas seus próprios dados incluídos. Ele não lê seus arquivos, não grava nada e não mantém nada entre chamadas.
Sem aconselhamento. Fatores de desperdício, fatores de expansão e pesos unitários são faixas de planejamento. Seu próprio histórico, seus fornecedores e seus engenheiros superam qualquer tabela.

Instalação

Clone o repositório em qualquer lugar. Python 3.9 ou posterior é tudo o que ele precisa.

git clone https://github.com/constructelligence-lab/construction-mcp.git

Em seguida, adicione-o ao seu cliente MCP. Substitua o caminho pelo local onde você o clonou.

Claude Code

claude mcp add construction-reference -- python3 /path/to/construction-mcp/server.py

Claude Desktop e outros clientes que aceitam uma configuração JSON:

{
  "mcpServers": {
    "construction-reference": {
      "command": "python3",
      "args": ["/path/to/construction-mcp/server.py"]
    }
  }
}

Nada é instalado em todo o sistema, e removê-lo é excluir a pasta e essa entrada.

Verifique se funciona

python3 -m unittest discover -s tests

Os testes iniciam o servidor real da mesma forma que um cliente e chamam todas as ferramentas. Para testar manualmente:

printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"markup_margin","arguments":{"cost":100000,"markup_percent":20}}}' | python3 server.py

Protocolo

JSON-RPC 2.0 sobre stdio, uma mensagem por linha. Implementa initialize, ping, tools/list, tools/call, resources/list e resources/read, e aceita versões de protocolo MCP 2025-11-25, 2025-06-18, 2025-03-26 e 2024-11-05. Os resultados das ferramentas trazem tanto um bloco de texto JSON quanto structuredContent. Problemas de entrada retornam como resultados de ferramentas com isError: true, para que o modelo possa corrigir sua chamada. O registro de log vai para stderr.

Dados

Os dados de referência são copiados de construction-data, que é onde as correções pertencem. Veja construction_mcp/data/SOURCE.md. Os códigos de custo usam uma numeração independente mapeada apenas para títulos de divisão CSI; eles são um ponto de partida, não um padrão.

Mais da Constructelligence

Recursos de construção abertos da mesma equipe, todos mantidos junto com este:

Repositório	O que é
IA na construção	Um guia prático para IA na construção: o que funciona hoje, como os dados precisam ser, os riscos e um plano de 90 dias.
Migração de dados de construção	Um guia e kit de ferramentas para mover uma contratada entre sistemas e provar que nada foi perdido.
Registros de projetos de construção	Esquemas abertos, modelos e um verificador para RFIs, submissões, eventos de mudança, relatórios diários e listas de pendências.
Dados de referência de construção	Códigos de custo, unidades, fatores de desperdício, unidades de pagamento, sequência de ofícios, glossário e fórmulas de métricas em CSV.
Prompts de construção	28 prompts para ChatGPT, Claude e Gemini, de decisão de proposta a cartas de aviso.
Habilidades de agente de construção	28 habilidades de agente instaláveis para Claude Code e qualquer agente que leia SKILL.md.
Ferramentas de construção de código aberto	Software de código aberto para BIM, CAD, cronograma e trabalho de campo, verificado contra a API do GitHub.

Licença

Código: MIT. Dados e documentação: CC BY 4.0. Veja LICENSE.

Mantido pela Constructelligence — construindo a infraestrutura de IA para construção.