Which integrations are available for this server?

Enables users to interact with the MCP server via Telegram, allowing them to request construction quotes, search for activities, list categories, and get detailed activity information through natural language messages.

How do I use Constructora Colombia MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Constructora Colombia MCP Server Cotiza 48m2 de enchape cerámico" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Constructora Colombia — MCP Server para OpenClaw

Sistema de cotizaciones inteligente para construcción colombiana.
OpenClaw es el cerebro (recibe mensajes por Telegram, razona, decide).
Python MCP Server es la herramienta (busca en Excel, calcula, extrae datos).

Arquitectura

Usuario → Telegram
              ↓
        OpenClaw Gateway ← canal Telegram nativo
              ↓  (razona, elige herramienta)
        MCP Server (Python)
              ↓  (datos crudos)
        OpenClaw analiza y responde
              ↓
Usuario ← Telegram

OpenClaw: IA que conversa con el usuario, decide qué tool usar e interpreta resultados
MCP Server: 5 herramientas Python que consultan el Excel de construcción
Excel: Fuente única de precios (1165 actividades, 21 recursos salariales, 18 capítulos)

Herramientas MCP

Herramienta	Qué hace
`buscar_actividades`	Búsqueda inteligente por similitud (rapidfuzz)
`cotizar`	Calcula cotización completa con detección de dimensiones
`interpretar`	Extrae intención, actividad y dimensiones del texto
`listar_categorias`	Lista los 18 capítulos de construcción disponibles
`obtener_detalle_actividad`	Desglose completo de recursos y precios unitarios

Uso con OpenCode (CLI)

cd /opt/constructora
opencode

OpenCode leerá AGENTS.md automáticamente y cargará las 5 herramientas MCP desde opencode.json. Puedes empezar a preguntar en lenguaje natural.

Uso con OpenClaw Gateway (Telegram)

# 1. Configurar y ejecutar setup
TELEGRAM_BOT_TOKEN="123:abc" TELEGRAM_USER_ID="123456" bash deploy/setup.sh

# 2. Iniciar Gateway
openclaw gateway

Instalación en Ubuntu

# 1. Clonar el repositorio
git clone <tu-repo> /opt/constructora
cd /opt/constructora

# 2. Ejecutar setup
TELEGRAM_BOT_TOKEN="123:abc" TELEGRAM_USER_ID="123456" bash deploy/setup.sh

El setup.sh:

Instala dependencias Python
Configura openclaw.json con tu token de Telegram
Crea servicio systemd opcional para el MCP Server
Verifica que el MCP Server funciona

Configuración manual de OpenClaw

Después de ejecutar setup.sh, tu openclaw.json se ve así:

{
  "mcpServers": {
    "constructora-colombia": {
      "command": "python3",
      "args": ["-m", "app.mcp_server"],
      "env": { "PYTHONPATH": "/opt/constructora" }
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "TU_TOKEN",
      "dmPolicy": "allowlist",
      "allowFrom": ["TU_USER_ID"]
    }
  }
}

Uso en Telegram

Ejemplos de mensajes que entiende el sistema:

Mensaje	Comportamiento
"Necesito cotización para poner cerámica en una habitación de 6x8"	Cotiza 48m2 de enchape
"Ponme baldosa barata"	Busca opciones de baldosa económica
"Cuanto vale pintar una pared de 10m2"	Cotiza pintura vinílica
"Panyete para 30m2"	Cotiza revoques
"Qué categorías hay?"	Lista capítulos disponibles
"Muéstrame actividades de PISOS"	Lista actividades de pisos
"Dame detalle de Enchape en cerámica"	Muestra APU completo

Desarrollo local (FastAPI)

Opcionalmente puedes correr la API HTTP para debug:

pip install -r requirements.txt
python -m app.main
# → http://localhost:8000/docs

Estructura del proyecto

constructora/
├── app/
│   ├── main.py                FastAPI (debug) + entry point MCP
│   ├── mcp_server.py          MCP Server con 5 herramientas
│   ├── config.py              Configuración
│   ├── database/
│   │   ├── excel_reader.py    Lector de Excel (pandas + openpyxl)
│   │   └── models.py          Modelos de datos
│   ├── tools/
│   │   ├── search.py          Búsqueda fuzzy (rapidfuzz)
│   │   └── calculator.py      Cálculo de cantidades
│   ├── api/
│   │   ├── routes.py          Endpoints REST
│   │   └── schemas.py         Pydantic schemas
│   └── utils/
│       └── text_parser.py     NLP: intención + dimensiones
├── data/
│   └── dataconstru.xlsx       Base de datos de construcción
├── deploy/
│   └── setup.sh               Script de instalación para Ubuntu
├── openclaw.json              Configuración para OpenClaw
├── requirements.txt
└── README.md

Próximas etapas

Embeddings semánticos (sentence-transformers + ChromaDB)
Búsqueda híbrida (fuzzy + vectorial)
RAG con precios web Colombia
PDFs profesionales (reportlab)
APU detallados con desglose de materiales
Historial de clientes y memoria conversacional

Licencia

MIT

Constructora Colombia MCP Server