Neodata MCP

Servidor MCP para usar Neodata Precios Unitarios (PU Win+) desde Claude (app de escritorio o Claude Code). Con él puedes pedirle a Claude que lea tus presupuestos, matrices e insumos, que exporte a Excel, que importe conceptos desde Excel o que edite la obra. También puede consultar Construbase.

Proyecto independiente, sin relación con Neodata S.A. de C.V. Úsalo bajo tu responsabilidad y trabaja con respaldos. Las escrituras ya hacen uno automático.

Cómo funciona

Neodata guarda cada obra como una base SQL Server (.mdf) en SQL Server LocalDB (localdb)\MSSQLLocalDB. El servidor se conecta con tu usuario de Windows, así que no usa la contraseña sa de Neodata. Para leer no hace falta tener Neodata abierto.

Related MCP server: MCP Database Server

Requisitos

• Windows con Neodata PU Win+ instalado. Neodata ya trae LocalDB y el ODBC Driver 17 for SQL Server.

• Python 3.10 o superior.

• La app Claude Desktop o Claude Code.

Instalación

1. Descarga este repositorio (botón Code → Download ZIP) y descomprímelo, por ejemplo en C:\neodata_mcp.

2. Instala las dependencias:

   pip install -r C:\neodata_mcp\requirements.txt

3. Registra el servidor:

   • Claude Code:

     claude mcp add neodata --scope user -- python -X utf8 C:\neodata_mcp\neodata_mcp.py

   • Claude Desktop: agrega esto en claude_desktop_config.json (en Configuración → Desarrollador → Editar config):

     {
       "mcpServers": {
         "neodata": {
           "command": "python",
           "args": ["-X", "utf8", "C:\\neodata_mcp\\neodata_mcp.py"]
         }
       }
     }

4. Reinicia Claude o abre una sesión nueva. Pídele "usa neodata_estado" para comprobar que encuentra tus obras.

Herramientas

Ejemplos de lo que puedes pedir:

• "Dame el resumen de mi obra por partida"

• "Muéstrame la matriz de CIM-001"

• "Exporta el presupuesto a Excel con factor de sobrecosto 1.28"

• "Busca en Construbase el precio de la plantilla de concreto de 5 cm"

• "Hazme la plantilla de importación", y después "importa este Excel a mi obra"

Seguridad al escribir

• Toda escritura es simulación por omisión: se ejecuta, muestra el resultado y se deshace. Para guardar hay que pedirlo explícitamente.

• Se niega a escribir si Neodata está abierto, para que Neodata no sobrescriba los cambios.

• Antes de cada escritura real hace un respaldo .bak en C:\NeodataWinPlusObras\respaldos_mcp, y cualquiera se puede restaurar.

• Usa los procedimientos almacenados de Neodata (NeoConceptos_GrabarActualizar, NeoMatrices_GrabarSoloMatriz, etc.), todo en una transacción: si algo falla, no se guarda nada.

• Guarda el costo directo. El precio unitario (indirectos, financiamiento, utilidad y cargos) lo calcula Neodata con su libro de sobrecosto. Después de editar, abre la obra en Neodata y ejecuta Cálculo.

Construbase

Descarga Construbase gratis desde neodata.mx/descargas (versión LDB). Descomprime el .mdf en C:\Neodata2021Obras y consúltalo como una obra más, por ejemplo con obra="Construbase_Octubre_2026" y presupuesto igual a CONSTRUCTOR, CONCURSOS, REMODELADOR o DESARROLLADOR. La primera consulta tarda 3–4 min, porque la base pesa ~850 MB y se abre en frío. Las siguientes tardan ~2 s.

Configuración opcional (variables de entorno)

Modelo de datos (por si quieres extenderlo)

PuCatalogo (códigos) → PuExpIns (código dentro de un presupuesto) → PuExpInsCostos (costo por moneda; 1 = M.N.). PuMatrices.IdCodigoMatriz e IdCodigoInsumo apuntan a PuExpIns. El importe de cada renglón es costo × cantidad (o costo ÷ cantidad si Dividir). Un insumo con EsPorcentaje = <tipo> vale un porcentaje del subtotal de ese tipo; por ejemplo, herramienta menor = 3 % de la mano de obra. Los conceptos (PuPresupuestosConceptos) cuelgan de las partidas (PuPresupuestosPartidas), que forman un árbol con IdPartidaPadre.

Probado con Neodata PU Win+ 2023.50 (estructura de base v21.1.0).