Construction MCP
Construcción MCP
Documentación
Servidor MCP de referencia de construcción
Un pequeño servidor Model Context Protocol sin conexión que brinda a un asistente de IA datos de referencia de construcción y calculadoras que de otro modo adivinaría: códigos de costos, términos de construcción, factores de desperdicio, unidades de pago, la secuencia típica de oficios, métricas de costos y cronograma, conversiones de unidades y calculadoras para concreto, acero de refuerzo, mampostería, asfalto, movimiento de tierras, valor ganado, retención y margen versus recargo.
Es un árbol de archivos de Python con sin dependencias, sin acceso a red y sin cuentas. Los datos se incluyen con él.
Herramientas
Consultas de referencia
| Herramienta | Pregúntale cosas como | Devuelve |
|---|---|---|
lookup_cost_code | "¿Qué código de costo para losa sobre el terreno?" "Lista la división 09" | Código, descripción, división CSI, tipo de costo, unidad, notas |
define_term | "¿Qué es la retención?" "¿Qué significa AHJ?" | Definiciones del glosario de contrato, control de costos, campo, seguridad y finanzas |
waste_factor | "¿Qué desperdicio debo considerar para los azulejos?" | Porcentajes bajo y alto de planificación, base y qué lo impulsa |
pay_unit | "¿Cómo se paga la excavación a granel?" | Unidad de pago, base de medición y exclusiones habituales |
trade_sequence | "¿Qué viene antes del panel de yeso?" | Oficio, actividad, predecesor, factor de duración y la restricción que suele afectar |
metric_formula | "¿Cómo se calcula el TCPI?" | Fórmula, entradas, interpretación y advertencias |
convert_units | "Convierte 2 M3 a CY" "450 PSF en KSF" | El resultado, el factor y las notas. Rechaza conversiones que necesitan más información, como LF a SF |
Calculadoras
| Herramienta | Pregúntale cosas como | Devuelve |
|---|---|---|
concrete_volume | "Losa de 40 por 30, 6 pulgadas de espesor" | CF y CY netos, y CY de pedido con un desperdicio dado o el rango de planificación |
rebar_weight | "100 barras #5 a 20 pies" | Libras y toneladas, con el rango de desperdicio |
masonry_units | "1,000 SF de muro de CMU con 80 SF de aberturas" | Unidades netas y con desperdicio |
asphalt_tonnage | "9,000 SF pavimentados a 3 pulgadas" | Toneladas netas y con desperdicio |
earthwork_volume | "1,000 yardas de banco de arcilla: ¿cuánto hay que transportar?" | Rangos de volumen suelto y compactado |
earned_value | "BAC 1M, EV 400k, AC 450k, PV 500k" | CV, SV, CPI, SPI, dos EAC, ETC, VAC y TCPI, con advertencias cuando es demasiado pronto para confiar en ellos |
retainage | "10% de retención sobre 500k facturados, 380k ya pagados" | Retención retenida y pendiente, y el monto adeudado |
markup_margin | "Costo 100,000 con 20% de recargo: ¿cuál es mi margen?" | Precio, ganancia, recargo y margen |
Cada herramienta es de solo lectura y le indica al modelo que sus resultados son valores de planificación que deben verificarse con tus propios datos.
Recursos
Los ocho conjuntos de datos detrás de las herramientas también se exponen como recursos MCP de solo lectura
(construction-reference://data/<name>.csv), para que un cliente pueda adjuntar una tabla completa a una conversación: códigos de costos,
glosario, factores de desperdicio, factores de movimiento de tierras, conversiones de unidades, unidades de pago, secuencia de oficios y fórmulas métricas. Solo
estos archivos incluidos se pueden leer.
Lo que no hace
- Sin red. Nunca abre un puerto ni hace una solicitud. Solo habla con la aplicación que lo lanzó, a través de la entrada y salida estándar.
- Sin conexiones. No se conecta a ningún sistema de contabilidad, gestión de proyectos o programación, ni a ningún producto o servidor de Constructelligence, ni a nada más.
- Sin archivos, sin memoria. Solo lee sus propios datos incluidos. No lee tus archivos, no escribe nada ni guarda nada entre llamadas.
- Sin asesoramiento. Los factores de desperdicio, los factores de expansión y los pesos unitarios son rangos de planificación. Tu propio historial, tus proveedores y tus ingenieros superan cualquier tabla.
Instalación
Clona el repositorio en cualquier lugar. Solo necesita Python 3.9 o posterior.
git clone https://github.com/constructelligence-lab/construction-mcp.git
Luego agrégalo a tu cliente MCP. Reemplaza la ruta con el lugar donde lo clonaste.
Claude Code
claude mcp add construction-reference -- python3 /path/to/construction-mcp/server.py
Claude Desktop y otros clientes que aceptan una configuración JSON:
{
"mcpServers": {
"construction-reference": {
"command": "python3",
"args": ["/path/to/construction-mcp/server.py"]
}
}
}
No se instala nada a nivel del sistema, y eliminarlo es borrar la carpeta y esa entrada.
Verifica que funciona
python3 -m unittest discover -s tests
Las pruebas inician el servidor real de la misma manera que lo hace un cliente y llaman a cada herramienta. Para probarlo 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, un mensaje por línea. Implementa initialize, ping, tools/list, tools/call, resources/list y resources/read,
y acepta versiones de protocolo MCP 2025-11-25, 2025-06-18, 2025-03-26 y 2024-11-05. Los resultados de las herramientas llevan
tanto un bloque de texto JSON como structuredContent. Los problemas de entrada vuelven como resultados de herramientas con isError: true,
para que el modelo pueda corregir su llamada. El registro va a stderr.
Datos
Los datos de referencia se copian de
construction-data, que es donde pertenecen las correcciones.
Consulta construction_mcp/data/SOURCE.md. Los códigos de costos usan una
numeración independiente mapeada solo a los títulos de división CSI; son un punto de partida, no un estándar.
Más de Constructelligence
Recursos de construcción abiertos del mismo equipo, todos mantenidos junto con este:
| Repositorio | Qué es |
|---|---|
| AI en la construcción | Una guía práctica de IA en la construcción: qué funciona hoy, cómo deben ser los datos, los riesgos y un plan de 90 días. |
| Migración de datos de construcción | Una guía y un kit de herramientas para mover a un contratista entre sistemas y demostrar que no se perdió nada. |
| Registros de proyectos de construcción | Esquemas abiertos, plantillas y un verificador para RFI, envíos, eventos de cambio, informes diarios y listas de verificación. |
| Datos de referencia de construcción | Códigos de costos, unidades, factores de desperdicio, unidades de pago, secuencia de oficios, glosario y fórmulas métricas en CSV. |
| Indicaciones de construcción | 28 indicaciones para ChatGPT, Claude y Gemini, desde oferta go/no-go hasta cartas de aviso. |
| Habilidades de agentes de construcción | 28 habilidades de agente instalables para Claude Code y cualquier agente que lea SKILL.md. |
| Herramientas de construcción de código abierto | Software de código abierto para BIM, CAD, programación y trabajo en sitio, verificado contra la API de GitHub. |
Licencia
Código: MIT. Datos y documentación: CC BY 4.0. Consulta LICENSE.
Mantenido por Constructelligence — construyendo la infraestructura de IA para la construcción.