presto-mcp-server

![CI](https://github.com/NeoNexAI/presto-mcp-server/actions/workflows/ci.yml) ![PyPI](https://pypi.org/project/presto-mcp-server/) ![Python](https://pypi.org/project/presto-mcp-server/) ![License: MIT](LICENSE)

MCP server que conecta Claude con Presto (software de presupuestos y mediciones de RIB Software) — versión 2025.

Por NeoNexAI Agency, para clientes de consultoría IA que usan Presto.

Dos vías complementarias:

COM en vivo (Presto.App.25) — controla la obra abierta en Presto:

leer/escribir conceptos, precios y cualquier campo, e invocar opciones internas del programa. Requiere Presto instalado y ejecutándose en el mismo equipo.

BC3 (FIEBDC-3) — lee y analiza ficheros de presupuesto sin abrir Presto

(multiplataforma; ideal para auditoría rápida).

Presto de escritorio no tiene API REST (eso es solo Presto ServerCloud). La integración local correcta es COM, que la documentación oficial de RIB soporta para VBScript, VB.NET y Python (win32com) — que es lo que usa este server.

---

Requisitos en el PC

Windows (la vía COM es Windows-only).
Python ≥ 3.10 + uv (pip install uv).
Presto 2025 instalado Y ABIERTO para la vía COM (control de la obra en vivo).

El MCP se conecta a la instancia de Presto en ejecución; para operar sobre una obra concreta, ábrela en Presto antes. Si tu versión no es la 25, fija el ProgID con PRESTO_PROGID (p. ej. Presto.App.26).

La vía BC3 NO necesita Presto (ni instalado ni abierto): solo lee/analiza

ficheros .bc3.

Comprueba la conexión en cualquier momento con la tool presto_status.

Resumen rápido: tools presto_bc3_* → funcionan siempre (solo ficheros). El resto (COM) → requieren Presto 2025 abierto en este mismo equipo.

---

Instalación

Publicado en PyPI como presto-mcp-server. uvx lo instala y ejecuta sin dejar nada que mantener; @latest trae siempre la última versión.

Opción 1 — con el comando de Claude Code (si tienes el CLI `claude`)

claude mcp add presto -s user -- uvx presto-mcp-server@latest

-s user lo deja disponible en todos los proyectos de ese PC. Para una versión de Presto distinta de la 2025: --env PRESTO_PROGID=Presto.App.26.

Opción 2 — sin CLI, editando la configuración a mano

Útil con Claude Desktop o si el comando claude no existe en el equipo. Añade el bloque "presto" dentro de mcpServers y reinicia la app:

Claude Desktop → C:\Users\<usuario>\AppData\Roaming\Claude\claude_desktop_config.json

(en la app: Settings → Developer → Edit Config).

Claude Code (config global de usuario) → C:\Users\<usuario>\.claude.json,

bajo la clave raíz mcpServers.

{
  "mcpServers": {
    "presto": {
      "command": "uvx",
      "args": ["presto-mcp-server@latest"],
      "env": { "PRESTO_PROGID": "Presto.App.25" }
    }
  }
}

Reinicia la app del todo (en Claude Desktop, ciérrala también desde el icono de la bandeja del sistema → Quit).

Si la app no encuentra uvx (PATH), pon la ruta absoluta como command (en PowerShell: where.exe uvx), con barras dobles \\ en el JSON.

Alternativas:

# con pip en vez de uv
pip install presto-mcp-server         # luego command="python", args=["-m","presto_mcp"]

# sin PyPI, directo de GitHub (no autoactualiza salvo --refresh)
uvx --from git+https://github.com/NeoNexAI/presto-mcp-server presto-mcp

Para la vía COM: abre Presto (y la obra, si la operación la necesita) antes de usar las herramientas. Comprueba la conexión con presto_status.

---

Herramientas

Conexión y obra

| Tool | Qué hace | |---|---| | presto_status | Comprueba la conexión COM y devuelve el ProgID activo | | presto_open_obra | Abre una obra .Presto en la instancia en ejecución | | presto_close_obra | Cierra la obra abierta |

Genéricas — cobertura del 100% del modelo de datos

| Tool | Qué hace | |---|---| | presto_read_records | Lee cualquier tabla/campos filtrando por máscara | | presto_get_field | Lee un campo de un registro por su código | | presto_set_field | Escribe un campo (transaccional, deshacible) | | presto_execute_option | Ejecuta cualquier opción interna de Presto (DLG_*) con JSON |

Curadas — conceptos y precios

| Tool | Qué hace | |---|---| | presto_get_concepto | Código, unidad, resumen y precios de un concepto | | presto_search_conceptos | Busca conceptos por resumen o código | | presto_get_precios | Precios en todos los esquemas (presupuesto, certificación, real, objetivo, planificado) | | presto_set_precio | Fija el precio de un concepto en un esquema | | presto_expresion | Calcula una expresión del motor de Presto (EvalStr/EvalNum) | | presto_tablas | Lista las tablas que el servidor conoce por su nombre canónico | | presto_selftest | Autodiagnóstico de solo lectura: un informe único OK/FALLO por paso |

BC3 (FIEBDC-3) — sin Presto

| Tool | Qué hace | |---|---| | presto_bc3_resumen | Resumen de un fichero BC3 (conceptos, capítulos, emisor) | | presto_bc3_buscar | Busca conceptos por texto en un BC3 | | presto_bc3_concepto | Concepto del BC3 con texto y descomposición | | presto_bc3_anomalias | Precios a 0/ausentes, sin resumen, partidas sin descomposición |

---

Modelo de datos de Presto (referencia rápida)

La automatización trabaja sobre tablas.campo. Los nombres exactos se ven en Presto con Ver: Lista de campos. Los más usados:

Tabla Conceptos: Conceptos.Código (clave única), Conceptos.Resumen,

Conceptos.Ud, y precios Conceptos.PrPres (presupuesto), PrCert (certificación), PrReal, PrObj (objetivo), PrPlan (planificado).

Filtrado por máscara con comodines de Presto: "E04", "hormigón", "".

Operaciones masivas (multiplicar precios, reducir niveles, generar objetivo, exportar/importar formatos…) → presto_execute_option con el código del diálogo.

---

¿Y Presto ServerCloud (WebAPI REST)?

Presto de escritorio no expone API REST. La WebAPI (REST sobre HTTP) solo existe con la licencia Presto ServerCloud (suscripción aparte + IIS). Por eso este MCP usa COM local (la vía correcta para escritorio + dongle/pincho).

Si algún día se contrata ServerCloud, no hace falta un MCP aparte: se añade a este mismo paquete una capa presto_webapi_* que se activa por variables de entorno (PRESTO_WEBAPI_URL / PRESTO_WEBAPI_USER / PRESTO_WEBAPI_PASS). Mientras no estén configuradas, el MCP funciona con COM + BC3 como siempre. → Un solo MCP, tres backends: COM (obra en vivo) · BC3 (ficheros) · WebAPI (solo si hay ServerCloud).

Desarrollo y tests

El reto de este MCP: la vía COM solo se puede probar de verdad con Presto abierto en Windows — y Presto no corre en CI ni en el equipo donde se desarrolla. Por eso hay dos niveles de test, cada uno cubre lo que el otro no puede:

pip install pytest
python -m pytest tests/ -v

tests/fake_presto_app.py — un objeto COM simulado (FakePrestoApp) que

reproduce los modos de fallo REALES de la API de Presto: máscara sin comillas → "Sintaxis incorrecta en expresión", campo no-clave como clave → "Clave incorrecta", tabla en minúscula → "Archivo incorrecto". Con él, tests/test_presto_com_mock.py ejercita el flujo completo (select→iterate→get_field, read_records en sus dos vías, set_field/Rename) sin necesitar Presto instalado. Cualquier regresión en presto_com.py se ve aquí en segundos, antes de publicar.

presto_selftest (tool MCP) — para el otro lado del problema: verificar

que una instalación de Presto REAL responde bien. Un solo mensaje del cliente ("ejecuta presto_selftest y pégame el resultado") sustituye a varias idas y vueltas probando tools sueltas. tests/test_selftest.py prueba su lógica (_run_selftest) contra el mock.

python -m py_compile src/presto_mcp/*.py     # comprobar sintaxis

Estado de validación: parser BC3 (6/6), helpers COM (8/8), flujo COM completo contra el mock (8/8), autodiagnóstico (4/4) — 26/26 tests, todos sin Presto instalado. El servidor MCP carga y registra 18 tools. La conexión COM contra un Presto real solo puede validarse en un equipo con Presto 2025 abierto: para eso está presto_selftest, pensado para que esa última validación sea un solo mensaje, no una sesión de pruebas.

---

Licencia

MIT · NeoNexAI Agency

presto-mcp-server