OpenHidro
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.
OpenHidro
Software livre de projeto hidrossanitário predial, feito para trabalhar junto com o Claude.
O OpenHidro dimensiona redes de água fria (ABNT NBR 5626 — método da soma dos pesos) e de esgoto sanitário (ABNT NBR 8160 — método das Unidades Hunter de Contribuição), lê a tubulação direto de um DXF e devolve memorial de cálculo, tabela de trechos e o DXF anotado com os diâmetros. Expõe tudo por um servidor MCP, então o Claude (ou outro assistente compatível) pode montar, calcular e revisar a rede junto com o engenheiro.
⚠️ Versão 0.1 — em desenvolvimento. Os resultados são preliminares e não substituem a responsabilidade técnica do engenheiro. Confira as tabelas com a norma vigente (ver docs/conferencia-normas.md).
O que já faz
Módulo | Situação |
Água fria — soma dos pesos, Fair-Whipple-Hsiao ou Darcy-Weisbach, perdas localizadas por comprimento equivalente, verificação de velocidade e de pressões dinâmica/estática, aumento automático de diâmetro até atender a pressão mínima | ✅ |
Esgoto — ramais de descarga, ramais de esgoto, tubos de queda, subcoletores e coletor (Tabelas 3 a 7), declividades mínimas, ramais de ventilação (Tabela 8), caixas sifonadas | ✅ |
Reservatórios — consumo diário por ocupação, reserva de 1 a 3 dias, reserva de incêndio, divisão superior/inferior | ✅ |
Leitura de DXF — linhas em camadas viram trechos, blocos viram aparelhos, derivações em "T" detectadas | ✅ |
Saídas — memorial em Markdown, CSV, JSON, DXF anotado | ✅ |
Servidor MCP para o Claude | ✅ |
Aplicativo de desktop: lançamento com mouse (água fria e esgoto), pavimentos, cálculo, lista de materiais Tigre/Amanco, prancha PDF com isométricos e esquema vertical, 3D, IFC4 | ✅ |
Claude dentro do aplicativo (servidor MCP | ✅ |
Água quente, águas pluviais (NBR 10844), coluna de ventilação desenhada | 🔜 ver roadmap |
Related MCP server: CAD MCP Server
Aplicativo de desktop
A interface gráfica fica em app/ — Tauri + TypeScript + Three.js. O instalador para
Windows é gerado automaticamente pelo GitHub a cada versão (aba Releases); o motor de cálculo
vai dentro dele, sem precisar de Python. Arquitetura e
etapas: docs/arquitetura.md e docs/roadmap.md.
Instalação do motor de cálculo (linha de comando / MCP)
git clone https://github.com/mgarvil/openhidro.git
cd openhidro
pip install -e ".[mcp,dev]"Uso rápido
# lista os aparelhos aceitos
openhidro aparelhos
# dimensiona uma rede descrita em JSON
openhidro calcular exemplos/residencia_agua_fria.json -o saida/
openhidro calcular exemplos/sobrado_esgoto.json -o saida/
# lê a tubulação de um DXF, dimensiona e grava o DXF anotado
python exemplos/gerar_dxf_exemplo.py
openhidro dxf exemplos/banheiro_af.dxf --config exemplos/banheiro_af_config.json -o saida/
# reservatório: 120 pessoas em escritório, 2 dias, 6.000 L de incêndio
openhidro reservatorio escritorio=120 --dias 2 --incendio 6000Usando com o Claude
Claude Code:
claude mcp add openhidro -- openhidro-mcpClaude Desktop (claude_desktop_config.json):
{ "mcpServers": { "openhidro": { "command": "openhidro-mcp" } } }Claude operando o aplicativo aberto (lança, calcula, gera prancha e exporta usando os mesmos comandos dos botões; tudo pode ser desfeito com Ctrl+Z):
{ "mcpServers": { "openhidro-app": { "command": "python", "args": ["-m", "openhidro.app_mcp"] } } }Depois é só pedir em português: "dimensione a água fria deste banheiro", "leia o DXF da planta
do 2º pavimento, camada HID-AF, e me devolva os diâmetros", "qual o volume de reservatório para
64 apartamentos?". A skill em .claude/skills/projeto-hidrossanitario
ensina o Claude a conduzir o projeto.
Formato da rede
Veja docs/formato-rede.md. Em resumo: nós (id, x, y, z, tipo,
aparelho) e trechos (de, para, conexoes, dn, declividade) formando uma árvore. Na
água fria os trechos vão do reservatório para os pontos; no esgoto, no sentido do escoamento.
Contribuindo
Engenheiros e programadores são bem-vindos. Leia CONTRIBUTING.md e o
CLAUDE.md — este último é o contexto que o Claude de cada colaborador lê ao abrir o
repositório, então cada um usa a própria conta e todos trabalham com as mesmas regras.
Toda mudança em tabela normativa precisa citar norma, edição, tabela e item.
Licença
GPL-3.0-or-later. O OpenHidro é e continuará livre. O desenvolvimento não usa código, bibliotecas, formatos internos nem interfaces de programas comerciais: parte apenas das normas técnicas e do conhecimento de engenharia dos colaboradores.
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
Read, query, edit and render DWG drawings with AI. No AutoCAD required.
DXF and PDF/X-4 for AI agents: structured facts, PNG renders, an interactive in-chat viewer.
Check floor-plan images, trace them into editable plans, export PDF and IFC, and query IFC models.
CAD in ChatGPT and Claude: editable parts, STEP/STL/drawings, in-chat 3D, automatic checks.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables Claude to control AutoCAD—draw, edit, query, layers, blocks, annotations, screenshots, plot to PDF—using plain language.812MIT
- AlicenseAqualityDmaintenanceEnables reading, analyzing, and editing CAD files (DXF and DWG) via natural language, including entity queries, layer management, and safe copy-based edits.171MIT
- AlicenseNot gradedqualityCmaintenanceEnables Claude to read and edit ZWCAD drawings directly, including summarizing drawings, querying layers and entities, reading dimensions and text, and creating lines, text, and blocks.1MIT
- AlicenseAqualityCmaintenanceEnables AI agents to create, inspect, render, and export 2D engineering drawings through DXF files, including entities, dimensions, hatches, splines, blocks, layers, PNG previews, and vector PDFs without needing a CAD GUI.11MIT